+
+
+
+
+
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 55ba20460bd..00000000000
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ /dev/null
@@ -1,6 +0,0 @@
-
+ merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}
+ >
+
+
+
+
+
+
+
+
+
+
-
- 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>
-
\ 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-modal.blade.php
similarity index 68%
rename from packages/framework/resources/views/components/docs/search-widget.blade.php
rename to packages/framework/resources/views/components/docs/search-modal.blade.php
index 53b8623188d..975f61170d2 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-modal.blade.php
@@ -1,10 +1,8 @@
-
+
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 @@
-
+
-
@foreach ($navigation->getItems() as $item)
-
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')
- diff --git a/packages/framework/resources/views/layouts/scripts.blade.php b/packages/framework/resources/views/layouts/scripts.blade.php index abc3a7030b5..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 Laravel Mix scripts --}} -@if(Asset::exists('app.js')) +{{-- The compiled Vite scripts --}} +@if(Vite::running()) + {{ Vite::assets(['resources/assets/app.js']) }} +@elseif(Asset::exists('app.js')) @endif 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 @@ {{-- The compiled Tailwind/App styles --}} -@if(config('hyde.load_app_styles_from_cdn', false)) - -@elseif(Asset::exists('app.css')) - -@endif +@if(Vite::running()) + {{ Vite::assets(['resources/assets/app.css']) }} +@else + @if(config('hyde.load_app_styles_from_cdn', false)) + + @elseif(Asset::exists('app.css')) + + @endif + -{{-- Dynamic TailwindCSS Play CDN --}} -@if(config('hyde.use_play_cdn', false)) - - - + {{-- Dynamic TailwindCSS Play CDN --}} + @if(config('hyde.use_play_cdn', false)) + + + + @endif @endif {{-- Add any extra styles to include after the others --}} diff --git a/packages/framework/resources/views/pages/docs/search.blade.php b/packages/framework/resources/views/pages/docs/search.blade.php index 9ea0c59474a..58f0c1a98d0 100644 --- a/packages/framework/resources/views/pages/docs/search.blade.php +++ b/packages/framework/resources/views/pages/docs/search.blade.php @@ -8,12 +8,8 @@ : 'Search ' . $title; @endphpFeatures::hasTorchlight()])> + {{ $content }} {{ $searchTitle }}
- -++@endsection diff --git a/packages/framework/src/Console/Commands/BuildSiteCommand.php b/packages/framework/src/Console/Commands/BuildSiteCommand.php index 84ecf1fda17..db199299638 100644 --- a/packages/framework/src/Console/Commands/BuildSiteCommand.php +++ b/packages/framework/src/Console/Commands/BuildSiteCommand.php @@ -26,11 +26,12 @@ 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}'; + {--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'; @@ -40,6 +41,8 @@ class BuildSiteCommand extends Command public function handle(): int { + $this->checkForDeprecatedRunMixCommandUsage(); + $timeStart = microtime(true); $this->title('Building your static site!'); @@ -85,6 +88,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(); } @@ -99,14 +106,6 @@ public function runPostBuildActions(): void 'prettify code' ); } - - if ($this->option('run-dev')) { - $this->runNodeCommand('npm run dev', 'Building frontend assets for development!'); - } - - if ($this->option('run-prod')) { - $this->runNodeCommand('npm run prod', 'Building frontend assets for production!'); - } } protected function printFinishMessage(float $timeStart): void @@ -158,4 +157,23 @@ 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 checkForDeprecatedRunMixCommandUsage(): void + { + if ($this->option('run-dev') || $this->option('run-prod')) { + $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.'); + + exit(Command::INVALID); + } + } } diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php index bcb8e11a192..676972a9ad8 100644 --- a/packages/framework/src/Console/Commands/ServeCommand.php +++ b/packages/framework/src/Console/Commands/ServeCommand.php @@ -5,9 +5,12 @@ namespace Hyde\Console\Commands; use Closure; +use Hyde\Facades\Filesystem; use Hyde\Hyde; 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; @@ -35,6 +38,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 */ @@ -42,6 +46,9 @@ class ServeCommand extends Command protected ConsoleOutput $console; + protected InvokedProcess $server; + protected ?InvokedProcess $vite = null; + public function safeHandle(): int { $this->configureOutput(); @@ -51,12 +58,18 @@ public function safeHandle(): int $this->openInBrowser((string) $this->option('open')); } + if ($this->option('vite')) { + $this->runViteProcess(); + } + $this->runServerProcess(sprintf('php -S %s:%d %s', $this->getHostSelection(), $this->getPortSelection(), $this->getExecutablePath() )); + $this->handleRunningProcesses(); + return Command::SUCCESS; } @@ -77,7 +90,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 @@ -102,7 +115,7 @@ protected function printStartMessage(): void { $this->useBasicOutput() ? $this->output->writeln('Starting the HydeRC server... 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 @@ -169,4 +182,51 @@ protected function getOpenCommand(string $osFamily): ?string default => null }; } + + 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.' + ); + } + + Filesystem::touch('app/storage/framework/cache/vite.hot'); + + $this->vite = Process::forever()->start('npm run dev'); + } + + protected function handleRunningProcesses(): void + { + while ($this->server->running()) { + $this->handleViteOutput(); + + Sleep::for(100)->milliseconds(); + } + } + + protected function handleViteOutput(): void + { + if ($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 + { + $socket = @fsockopen('localhost', $port, $errno, $errstr, 1); + if ($socket !== false) { + fclose($socket); + + return false; + } + + return true; + } } diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php index 9f3c4135ff6..ed1dd511888 100644 --- a/packages/framework/src/Facades/HydeFront.php +++ b/packages/framework/src/Facades/HydeFront.php @@ -32,16 +32,10 @@ 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 - * - * @link https://cdn.jsdelivr.net/npm/hydefront@latest/dist/ for the available files. - */ - public static function cdnLink(string $file): string + /** 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(), $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/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php new file mode 100644 index 00000000000..814aff2b07c --- /dev/null +++ b/packages/framework/src/Facades/Vite.php @@ -0,0 +1,79 @@ + $paths */ + public static function assets(array $paths): HtmlString + { + $html = ''; + + foreach ($paths as $path) { + $html .= static::formatAssetPath($path); + } + + return new HtmlString($html); + } + + /** @throws InvalidArgumentException If the asset type is not supported. */ + protected static function formatAssetPath(string $path): string + { + if (static::isCssPath($path)) { + return static::formatStylesheetLink($path); + } + + if (static::isJsPath($path)) { + return static::formatScriptInclude($path); + } + + // 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 isCssPath(string $path): bool + { + return static::checkFileExtensionForPath($path, static::CSS_EXTENSIONS); + } + + protected static function isJsPath(string $path): bool + { + 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 + { + return sprintf('', $path); + } + + protected static function formatScriptInclude(string $path): string + { + return sprintf('', $path); + } +} diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php index 2889b0fe419..f1457712b5a 100644 --- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php +++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php @@ -6,64 +6,177 @@ use Hyde\Facades\Config; use Hyde\Markdown\Models\Markdown; -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; +use Hyde\Markdown\Processing\HeadingRenderer; /** - * Generates a table of contents for the Markdown document, most commonly used for the sidebar. + * Generates a nested table of contents from Markdown headings. */ 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); + } + + /** @return array- ');
- if ($position === false) {
- // The document has no headings, so we'll just return an empty string.
- return '';
+ return [
+ 'level' => $headingData['level'],
+ 'title' => $headingData['title'],
+ 'identifier' => HeadingRenderer::makeIdentifier($headingData['title']),
+ ];
+ }
+
+ /**
+ * @param array
-
+
+ #
+ Level 2
+
+
-
+
- + + # + Level 3 + + +
+ - + + # + Level 2 + + +
- + + # + Level 2B + + +
-
+
+ #
+ Level 2
+
+
-
+
- + + # + Level 3 + + +
+ -
+
+ #
+ Level 2
+
+
-
+
-
+
+ #
+ Level 3
+
+
-
+
- + + # + Level 4 + + +
+
+ -
+
+ #
+ Level 3
+
+
-
+
+ #
+ Level 2B
+
+
-
+
- + + # + Level 3B + + +
- + + # + Level 3C + + +
+ -
+
+ #
+ Level 2C
+
+
-
+
- + + # + Level 3D + + +
+ -
+
+ #
+ Level 2
+
+
-
+
- + + # + Level 3 + + +
+ -
+
+ #
+ Level 2B
+
+
-
+
- + + # + Level 3B + + +
+
Tracks all the headings in the document to ensure identifiers are unique */ + protected array $headingRegistry = []; + public function __construct(string $markdown, ?string $pageClass = null) { $this->pageClass = $pageClass; @@ -87,6 +91,8 @@ protected function setupConverter(): void $this->initializeExtension($extension); } + $this->configureCustomHeadingRenderer(); + $this->registerPreProcessors(); $this->registerPostProcessors(); } @@ -141,13 +147,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; @@ -166,19 +165,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); @@ -200,22 +186,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); @@ -270,4 +240,11 @@ protected static function findLineContentPositions(array $lines): array return [0, 0]; } + + protected function configureCustomHeadingRenderer(): void + { + $this->converter->getEnvironment()->addRenderer(Heading::class, + new HeadingRenderer($this->pageClass, $this->headingRegistry) + ); + } } diff --git a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php index a757eadb1c7..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 { @@ -76,24 +78,38 @@ 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, 'Filepath: foo.html 1+
HTML; $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html)); @@ -230,7 +230,7 @@ public function testProcessorEscapesHtmlByDefault() $escaped = e('Link'); $expected = <<Filepath: foo.html1Filepath: $escaped+
HTML; $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html)); @@ -246,7 +246,7 @@ public function testProcessorDoesNotEscapeHtmlIfConfigured() HTML; $expected = <<<'HTML' -Filepath: $escaped
+Filepath: Link
HTML; $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html)); diff --git a/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php index 20aac354cdc..b7ff55d50eb 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('Filepath: Link
', $processor->run()); + $this->assertSame(<<<'HTML' +foo
+
+ HTML, $processor->run()); } public function testStringWithoutShortcodeIsNotModified() @@ -46,8 +54,11 @@ public function testStringWithoutShortcodeIsNotModified() public function testProcessStaticShorthand() { $this->assertSame( - 'foo
+
', - ShortcodeProcessor::preprocess('>info foo') + <<<'HTML' +foo
+
+ HTML, ShortcodeProcessor::preprocess('>info foo') ); } 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('', $html); - $this->assertStringContainsString('', $html); + $this->assertStringContainsString('assertStringContainsString('', $html); $this->assertStringContainsString('foo
+', $html); $this->assertStringContainsString(' ', $html); diff --git a/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php b/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php index 9584f15907f..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', - 'CHAPTER I. DOWN THE RABBIT-HOLE.
', + 'CHAPTER I. DOWN THE RABBIT-HOLE.#
', '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', - '
CHAPTER I. DOWN THE RABBIT-HOLE.
', + 'CHAPTER I. DOWN THE RABBIT-HOLE.#
', 'So she was considering in her own mind, as well as she could', ], '_site/test-page.html'); } diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php index 580139033ba..64376c3aa23 100644 --- a/packages/framework/tests/Feature/StaticSiteServiceTest.php +++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php @@ -160,15 +160,13 @@ public function testNodeActionOutputs() { Process::fake(); - $this->artisan('build --run-prettier --run-dev --run-prod') - ->expectsOutput('Prettifying code! This may take a second.') - ->expectsOutput('Building frontend assets for development! This may take a second.') + $this->artisan('build --run-prettier --run-vite') ->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 === 'npm run build'); 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'); } public function testPrettyUrlsOptionOutput() diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php new file mode 100644 index 00000000000..5f1e09c5833 --- /dev/null +++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php @@ -0,0 +1,388 @@ +render($markdown); + + $this->assertIsString($result); + + $this->assertHtmlStructure(<<<'HTML' +
-
+
-
+
-
+
-
+
-
+
+
+ HTML, ColoredBlockquotes::resolve('>info foo') + ); + } + + public function testCanUseMarkdownWithinBlockquote() + { + $this->assertSame( + <<<'HTML' +foo
++
+ HTML, ColoredBlockquotes::resolve('>info foo **bar**') + ); + } + + public function testWithUnrelatedClass() + { + $this->assertSame( + '>foo foo', + ColoredBlockquotes::resolve('>foo foo') + ); + } + + /** + * @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' +foo bar
++
+ HTML, + ], + [ + '>info This is an info blockquote', + <<<'HTML' +This is a danger blockquote
++
+ HTML, + ], + [ + '>success This is a success blockquote', + <<<'HTML' +This is an info blockquote
++
+ HTML, + ], + [ + '>warning This is a warning blockquote', + <<<'HTML' +This is a success blockquote
++
+ HTML, + ], + ]; + } +} diff --git a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php index 2ac04884afe..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 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')); + $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/app.css'; + $this->assertSame($expected, HydeFront::cdnLink()); } public function testInjectTailwindConfigReturnsExtractedTailwindConfig() diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php new file mode 100644 index 00000000000..45adda783c4 --- /dev/null +++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php @@ -0,0 +1,190 @@ +cleanUpFilesystem(); + } + + public function testRunningReturnsTrueWhenViteHotFileExists() + { + $this->file('app/storage/framework/cache/vite.hot'); + + $this->assertTrue(Vite::running()); + } + + public function testRunningReturnsFalseWhenViteHotFileDoesNotExist() + { + $this->assertFileDoesNotExist('app/storage/framework/cache/vite.hot'); + + $this->assertFalse(Vite::running()); + } + + public function testItAlwaysImportsClientModule() + { + $html = Vite::assets([]); + + $this->assertStringContainsString('', (string) $html); + + $html = Vite::assets(['foo.js']); + + $this->assertStringContainsString('', (string) $html); + } + + public function testAssetMethodThrowsExceptionForUnknownExtensions() + { + $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() + { + $this->assertInstanceOf(HtmlString::class, Vite::assets([])); + $this->assertInstanceOf(HtmlString::class, Vite::assets(['foo.js'])); + + $this->assertEquals(new HtmlString(''), Vite::assets([])); + $this->assertEquals(new HtmlString(''), Vite::assets(['foo.js'])); + } + + public function testAssetsMethodGeneratesCorrectHtmlForJavaScriptFiles() + { + $html = Vite::assets(['resources/js/app.js']); + + $expected = ''; + + $this->assertSame($expected, (string) $html); + } + + public function testAssetsMethodGeneratesCorrectHtmlForCssFiles() + { + $html = Vite::assets(['resources/css/app.css']); + + $expected = ''; + + $this->assertSame($expected, (string) $html); + } + + public function testAssetsMethodGeneratesCorrectHtmlForMultipleFiles() + { + $html = Vite::assets([ + 'resources/js/app.js', + 'resources/css/app.css', + 'resources/js/other.js', + ]); + + $expected = ''; + + $this->assertSame($expected, (string) $html); + } + + /** + * @dataProvider cssFileExtensionsProvider + */ + public function testAssetsMethodSupportsAllCssFileExtensions(string $extension) + { + $html = Vite::assets(["resources/css/app.$extension"]); + + if ($extension !== 'js') { + $expected = ''; + + $this->assertStringContainsString('stylesheet', (string) $html); + $this->assertSame($expected, (string) $html); + } else { + $this->assertStringNotContainsString('stylesheet', (string) $html); + } + } + + /** + * @dataProvider jsFileExtensionsProvider + */ + public function testAssetsMethodSupportsAllJsFileExtensions(string $extension) + { + $html = Vite::assets(["resources/js/app.$extension"]); + + if ($extension !== 'css') { + $expected = ''; + + $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')); + } + + public function testAssetMethodGeneratesCorrectHtmlForJavaScriptFile() + { + $html = Vite::asset('resources/js/app.js'); + + $expected = ''; + + $this->assertSame($expected, (string) $html); + } + + public function testAssetMethodGeneratesCorrectHtmlForCssFile() + { + $html = Vite::asset('resources/css/app.css'); + + $expected = ''; + + $this->assertSame($expected, (string) $html); + } + + public static function cssFileExtensionsProvider(): array + { + return [ + ['css'], + ['less'], + ['sass'], + ['scss'], + ['styl'], + ['stylus'], + ['pcss'], + ['postcss'], + ['js'], + ]; + } + + public static function jsFileExtensionsProvider(): array + { + return [ + ['js'], + ['jsx'], + ['ts'], + ['tsx'], + ['css'], + ]; + } +} diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php new file mode 100644 index 00000000000..32952775d32 --- /dev/null +++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php @@ -0,0 +1,532 @@ +execute(); + + $this->assertSame([ + [ + 'title' => 'Level 2', + 'identifier' => 'level-2', + 'children' => [], + ], + [ + 'title' => 'Level 2B', + 'identifier' => 'level-2b', + 'children' => [ + [ + 'title' => 'Level 3', + 'identifier' => 'level-3', + 'children' => [], + ], + ], + ], + ], $result); + } + + public function testReturnStringContainsExpectedContent() + { + $markdown = <<<'MARKDOWN' + # Level 1 + ## Level 2 + ### Level 3 + MARKDOWN; + + $result = (new GeneratesTableOfContents($markdown))->execute(); + + $this->assertSame([ + [ + 'title' => 'Level 2', + 'identifier' => 'level-2', + 'children' => [ + [ + 'title' => 'Level 3', + 'identifier' => 'level-3', + 'children' => [], + ], + ], + ], + ], $result); + } + + 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->assertSame( + [ + [ + 'title' => 'Level 2', + 'identifier' => 'level-2', + 'children' => [], + ], + [ + 'title' => 'Level 2B', + 'identifier' => 'level-2b', + 'children' => [], + ], + ], + (new GeneratesTableOfContents($markdown))->execute(), + ); + } + + public function testNonHeadingMarkdownIsIgnored() + { + $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() + ); + + $this->assertSame( + [ + [ + 'title' => 'Level 2', + 'identifier' => 'level-2', + 'children' => [ + [ + 'title' => 'Level 3', + 'identifier' => 'level-3', + 'children' => [], + ], + ], + ], + ], + (new GeneratesTableOfContents($actual))->execute(), + ); + } + + public function testWithNoLevelOneHeading() + { + $markdown = <<<'MARKDOWN' + ## Level 2 + ### Level 3 + MARKDOWN; + + $result = (new GeneratesTableOfContents($markdown))->execute(); + + $this->assertSame([ + [ + 'title' => 'Level 2', + 'identifier' => 'level-2', + 'children' => [ + [ + 'title' => 'Level 3', + 'identifier' => 'level-3', + 'children' => [], + ], + ], + ], + ], $result); + } + + 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; + + $result = (new GeneratesTableOfContents($markdown))->execute(); + + $this->assertSame([ + [ + 'title' => 'Level 2', + 'identifier' => 'level-2', + 'children' => [ + [ + 'title' => 'Level 3', + 'identifier' => 'level-3', + 'children' => [ + [ + 'title' => 'Level 4', + 'identifier' => 'level-4', + 'children' => [], + ], + ], + ], + ], + ], + [ + 'title' => 'Level 2B', + 'identifier' => 'level-2b', + 'children' => [ + [ + 'title' => 'Level 3B', + 'identifier' => 'level-3b', + 'children' => [], + ], + [ + 'title' => 'Level 3C', + 'identifier' => 'level-3c', + 'children' => [], + ], + ], + ], + [ + 'title' => 'Level 2C', + 'identifier' => 'level-2c', + 'children' => [ + [ + 'title' => 'Level 3D', + 'identifier' => 'level-3d', + 'children' => [], + ], + ], + ], + ], $result); + } + + public function testWithMultipleLevelOneHeadings() + { + $markdown = <<<'MARKDOWN' + # Level 1 + ## Level 2 + ### Level 3 + # Level 1B + ## Level 2B + ### Level 3B + MARKDOWN; + + $result = (new GeneratesTableOfContents($markdown))->execute(); + + $this->assertSame([ + [ + 'title' => 'Level 2', + 'identifier' => 'level-2', + 'children' => [ + [ + 'title' => 'Level 3', + 'identifier' => 'level-3', + 'children' => [], + ], + ], + ], + [ + 'title' => 'Level 2B', + 'identifier' => 'level-2b', + 'children' => [ + [ + 'title' => 'Level 3B', + 'identifier' => 'level-3b', + 'children' => [], + ], + ], + ], + ], $result); + } + + public function testWithNoHeadings() + { + $this->assertSame([], (new GeneratesTableOfContents("Foo bar\nBaz foo"))->execute()); + } + + 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', + 'identifier' => 'level-3', + 'children' => [ + [ + 'title' => 'Level 4', + 'identifier' => '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', + 'identifier' => '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', + 'identifier' => 'level-2', + 'children' => [ + [ + 'title' => 'Level 3', + 'identifier' => 'level-3', + 'children' => [], + ], + ], + ], + ], $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', + 'identifier' => 'level-1', + 'children' => [ + [ + 'title' => 'Level 2', + 'identifier' => 'level-2', + 'children' => [ + [ + 'title' => 'Level 3', + 'identifier' => 'level-3', + 'children' => [ + [ + 'title' => 'Level 4', + 'identifier' => 'level-4', + 'children' => [ + [ + 'title' => 'Level 5', + 'identifier' => 'level-5', + 'children' => [ + [ + 'title' => 'Level 6', + 'identifier' => 'level-6', + 'children' => [], + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], $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', + 'identifier' => 'level-1', + 'children' => [ + [ + 'title' => 'Level 2', + 'identifier' => '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', + 'identifier' => '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()); + } +} diff --git a/packages/framework/tests/Unit/HasTableOfContentsTest.php b/packages/framework/tests/Unit/HasTableOfContentsTest.php deleted file mode 100644 index 2995b0b509e..00000000000 --- a/packages/framework/tests/Unit/HasTableOfContentsTest.php +++ /dev/null @@ -1,27 +0,0 @@ -assertSame( - '', - str_replace("\n", '', (new DocumentationPage(markdown: '## Title'))->getTableOfContents()) - ); - } -} diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php new file mode 100644 index 00000000000..2b71abb4677 --- /dev/null +++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php @@ -0,0 +1,316 @@ +createRealBladeCompilerEnvironment(); + + self::mockConfig(['markdown' => self::$cachedConfig ??= require __DIR__.'/../../config/markdown.php']); + } + + 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); + } + + 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('This is a warning blockquote
+Test Heading#
', $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 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 testAddsPermalinksBasedOnConfiguredHeadingLevels(): void + { + $childRenderer = $this->mockChildNodeRenderer('Test Content'); + $renderer = new HeadingRenderer(DocumentationPage::class); + + 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() + { + $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 group w-fit scroll-mt-2', $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 group w-fit scroll-mt-2"', $rendered); + $this->assertStringContainsString('foo="bar"', $rendered); + } + + public function testCanAddPermalinkReturnsFalseForExistingPermalink(): void + { + $renderer = new HeadingRenderer(DocumentationPage::class); + $content = 'Test Content'; + + $result = $renderer->canAddPermalink($content, 2); + + $this->assertFalse($result); + } + + public function testCanAddPermalinkReturnsFalseForNotEnabledPageClass(): void + { + $renderer = new HeadingRenderer(MarkdownPage::class); + + $this->assertFalse($renderer->canAddPermalink('Test Content', 2)); + } + + public function testCanAddPermalinkWithCustomPageClasses(): void + { + self::mockConfig([ + 'markdown.permalinks.pages' => [DocumentationPage::class, MarkdownPage::class], + ]); + + $renderer = new HeadingRenderer(MarkdownPage::class); + + $this->assertTrue($renderer->canAddPermalink('Test Content', 2)); + } + + public function testPostProcessMethodNormalizesInputToMatchCommonMark() + { + // Actual HTML output returned from Blade + $html = <<<'HTML' ++ Test Heading + # +
+ HTML; + + // What CommonMark would generate from the same input Markdown + $expected = 'Test Heading#
'; + + $this->assertSame($expected, (new HeadingRenderer())->postProcess($html)); + } + + public function testPostProcessRemovesSpacesCausedByNoExtraBladeAttributes() + { + $html = "Title
\nSubtitle
"; + + $this->assertSame('Title
Subtitle
', (new HeadingRenderer())->postProcess($html)); + } + + public function testPostProcessRemovesSpacesCausedByNoExtraBladeAttributesButLeavesExtraAttributesAlone() + { + $html = "Title
\nSubtitle
"; + + $this->assertSame('Title
Subtitle
', (new HeadingRenderer())->postProcess($html)); + } + + public function testPostProcessTrimsWhitespaceAndIndentationFromLines() + { + $html = "Title
\nSubtitle
"; + + $this->assertSame('Title
Subtitle
', (new HeadingRenderer())->postProcess($html)); + } + + public function testPostProcessTrimsEmptyClassAttributes() + { + $html = 'Title
'; + + $this->assertSame('Title
', (new HeadingRenderer())->postProcess($html)); + } + + public function testPostProcessHandlesEmptyString() + { + $html = ''; + + $this->assertSame('', (new HeadingRenderer())->postProcess($html)); + } + + public function testPostProcessHandlesNoHeadingTags() + { + $html = 'Paragraph
'; + + $this->assertSame('Paragraph
', (new HeadingRenderer())->postProcess($html)); + } + + /** + * @dataProvider headingIdentifierProvider + */ + 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); + $childRenderer->shouldReceive('renderNodes')->andReturn($contents); + + 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); + } + } + } + + public static function headingIdentifierProvider(): array + { + return [ + // 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-and-symbol'], + ['Heading with < > symbols', 'heading-with-symbols'], + ['Heading with "quotes"', 'heading-with-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'], + ['中文标题', 'zhong-wen-biao-ti'], + ['日本語の見出し', 'ri-ben-yu-nojian-chu-shi'], + ['한국어 제목', 'hangugeo-jemog'], + + // Edge cases + [' Leading spaces', 'leading-spaces'], + ['Trailing spaces ', 'trailing-spaces'], + [' Surrounded by spaces ', 'surrounded-by-spaces'], + ['----', ''], + ['%%%%%%%', ''], + [' ', ''], + ['1234567890', '1234567890'], + ]; + } +} diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php index 17f982db1de..548132af104 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; @@ -40,6 +41,8 @@ protected function setUp(): void protected function tearDown(): void { $this->verifyMockeryExpectations(); + + app()->forgetInstance(Filesystem::class); } public function testPathReturnsTheIncludesDirectory() @@ -144,12 +147,12 @@ 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); }); + $this->mockViewFactory($expected); + $this->assertHtmlStringIsSame($expected, Includes::markdown($filename)); } @@ -163,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)); } @@ -179,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')); @@ -235,13 +242,25 @@ public function testBladeReturnsDefaultValueWhenNotFound() protected function mockFilesystemFromClosure(Closure $config): void { - $filesystem = Mockery::mock(Filesystem::class); + $filesystem = Mockery::mock(Filesystem::class)->makePartial(); $config($filesystem); 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); diff --git a/packages/framework/tests/Unit/MarkdownHelpersTest.php b/packages/framework/tests/Unit/MarkdownHelpersTest.php index 0d3ac1982cc..e0784327102 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'Hello World
-
+Colored blockquote
+
HTML, $html); diff --git a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php index f76d70e35ee..eeaa62b5a47 100644 --- a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php +++ b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php @@ -335,6 +335,17 @@ public function testGetOpenCommandForUnknownOS() $this->assertNull($this->getMock()->getOpenCommand('UnknownOS')); } + 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) { @@ -367,6 +378,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 @@ -376,6 +389,38 @@ 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 + { + } + }; + } } /** 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('renderTestView()); } - - public function testComponentDoesNotRenderCdnLinkWhenALocalFileExists() - { - Filesystem::touch('_media/hyde.css'); - $this->assertStringNotContainsString('https://cdn.jsdelivr.net/npm/hydefront', $this->renderTestView()); - Filesystem::unlink('_media/hyde.css'); - } } diff --git a/packages/hyde/README.md b/packages/hyde/README.md index 3a2f42d8436..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 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 Tailwind and Vite setup. ### Customization 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() diff --git a/packages/hydefront/.github/scripts/post-build.php b/packages/hydefront/.github/scripts/post-build.php index 6af4f339e1a..d7ef81f2e89 100644 --- a/packages/hydefront/.github/scripts/post-build.php +++ b/packages/hydefront/.github/scripts/post-build.php @@ -25,105 +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']; - $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; - } - - $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"); - - $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'); - $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 !== $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'"); - $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); -} 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(); 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/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 diff --git a/packages/hydefront/.github/workflows/node.js.yml b/packages/hydefront/.github/workflows/node.js.yml deleted file mode 100644 index 42a5b430521..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 prod - - - 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' diff --git a/packages/hydefront/README.md b/packages/hydefront/README.md index bd7f6ebb3e6..e7b066cc2ad 100644 --- a/packages/hydefront/README.md +++ b/packages/hydefront/README.md @@ -4,7 +4,6 @@ [](https://www.npmjs.com/package/hydefront) [](https://github.com/hydephp/hydefront) [](https://www.npmjs.com/package/hydefront) -[](https://github.com/hydephp/hydefront/actions/workflows/node.js.yml) ## About this repository @@ -13,14 +12,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 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. 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 @@ -40,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 | diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css new file mode 100644 index 00000000000..062aa04f85a --- /dev/null +++ b/packages/hydefront/components/torchlight.css @@ -0,0 +1,59 @@ +/* + * This file contains the default styles for the Torchlight syntax highlighter. + * 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 { + @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 { + @apply outline-none; +} + +.torchlight details > summary::marker, .torchlight details > summary::-webkit-details-marker { + @apply hidden; +} + +.torchlight details .summary-caret::after { + @apply 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 { + @apply hidden; +} + +.torchlight details:not([open]) .summary-hide-when-open { + @apply block; +} diff --git a/packages/hydefront/dist/app.css b/packages/hydefront/dist/app.css index e18eeec73b8..8cc270c5bc4 100644 --- a/packages/hydefront/dist/app.css +++ b/packages/hydefront/dist/app.css @@ -1,4 +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} -*,: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: } - -/*! tailwindcss v3.4.15 | 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,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}} +.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/dist/hyde.css b/packages/hydefront/dist/hyde.css deleted file mode 100644 index cd697712eee..00000000000 --- a/packages/hydefront/dist/hyde.css +++ /dev/null @@ -1,2 +0,0 @@ -/*! 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{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}}/*# 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 c4ab8ac5433..00000000000 --- a/packages/hydefront/dist/hyde.css.map +++ /dev/null @@ -1 +0,0 @@ -{"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"],"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","file":"hyde.css"} \ No newline at end of file diff --git a/packages/hydefront/hyde.scss b/packages/hydefront/hyde.scss deleted file mode 100644 index 4242ea03c27..00000000000 --- a/packages/hydefront/hyde.scss +++ /dev/null @@ -1,13 +0,0 @@ -/** - * Core Stylesheet for the HydePHP Frontend - * - * @package HydePHP - HydeFront - * @version v3.x (HydeFront) - * @author Caen De Silva - */ - -@use 'sass/hyde-docs'; -@use 'sass/markdown/torchlight'; -@use 'sass/markdown/blockquotes'; -@use 'sass/markdown/codeblocks'; -@use 'sass/utilities/alpine'; diff --git a/packages/hydefront/package-lock.json b/packages/hydefront/package-lock.json index 3c1a80b62d4..622e8ab092a 100644 --- a/packages/hydefront/package-lock.json +++ b/packages/hydefront/package-lock.json @@ -7,467 +7,7 @@ "": { "name": "hydefront", "version": "3.4.1", - "license": "MIT", - "devDependencies": { - "sass": "1.82.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.82.0", - "resolved": "https://registry.npmjs.org/sass/-/sass-1.82.0.tgz", - "integrity": "sha512-j4GMCTa8elGyN9A7x7bEglx0VgSpNUG4W4wNedQ33wSMdnkqQCT8HTwOaVSV4e6yQovcu/3Oc4coJP/l0xhL2Q==", - "dev": true, - "license": "MIT", - "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 24d47717472..e2ec548480d 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": { - "prod": "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" @@ -21,9 +16,5 @@ "bugs": { "url": "https://github.com/hydephp/hydefront/issues" }, - "homepage": "https://github.com/hydephp/hydefront#readme", - "devDependencies": { - "sass": "1.82.0" - }, - "main": "dist/hyde.css" + "homepage": "https://github.com/hydephp/hydefront#readme" } 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/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/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/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 deleted file mode 100644 index 2641ec3595c..00000000000 --- a/packages/hydefront/sass/hyde-docs.scss +++ /dev/null @@ -1,12 +0,0 @@ -/** - * HydeDocs Core CSS - */ - -@use 'docs/search'; -@use 'docs/sidebar-toggle'; -@use 'docs/table-of-contents'; -@use 'docs/heading-permalinks'; - -html { - scroll-behavior: smooth; -} 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/packages/hydefront/sass/markdown/codeblocks.scss b/packages/hydefront/sass/markdown/codeblocks.scss deleted file mode 100644 index dc0cf34f5ed..00000000000 --- a/packages/hydefront/sass/markdown/codeblocks.scss +++ /dev/null @@ -1,39 +0,0 @@ -// 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 { - position: relative; - top: -.25rem; - right: 0.25rem; - float: right; - opacity: .5; - transition: opacity 0.25s; - - &:hover { - opacity: 1; - } -} - -.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 { - display: none; - } -} 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/packages/hydefront/sass/utilities/alpine.scss b/packages/hydefront/sass/utilities/alpine.scss deleted file mode 100644 index 11b2deaaa58..00000000000 --- a/packages/hydefront/sass/utilities/alpine.scss +++ /dev/null @@ -1,3 +0,0 @@ -@media screen and (min-width: 768px) { - [x-cloak].x-uncloak-md { display: revert !important; } -} 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..aee5828f9c3 --- /dev/null +++ b/packages/realtime-compiler/resources/vite-index-page.html @@ -0,0 +1,66 @@ + + + + + + +Colored blockquote
+HydePHP Vite + + + + + + +++ + 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/src/ConsoleOutput.php b/packages/realtime-compiler/src/ConsoleOutput.php index 99868f6254c..e756e026a76 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; @@ -24,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); @@ -35,6 +36,8 @@ public function printStartMessage(string $host, int $port, array $environment = sprintf('Listening on: %s', $url, $url), (config('hyde.server.dashboard.enabled') || Arr::has($environment, 'HYDE_SERVER_DASHBOARD')) && Arr::get($environment, 'HYDE_SERVER_DASHBOARD') === 'enabled' ? sprintf('Live dashboard: %s/dashboard', $url, $url) : null, + (Vite::running() || $willUseVite) ? + sprintf('Vite HMR server: http://%s:5173', $host, $host) : 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() diff --git a/packages/testing/src/UsesRealBladeInUnitTests.php b/packages/testing/src/UsesRealBladeInUnitTests.php new file mode 100644 index 00000000000..30e1af963d2 --- /dev/null +++ b/packages/testing/src/UsesRealBladeInUnitTests.php @@ -0,0 +1,38 @@ +register('blade', function () use ($filesystem) { + return new CompilerEngine( + new BladeCompiler($filesystem, sys_get_temp_dir()) + ); + }); + + $finder = new FileViewFinder($filesystem, [Hyde::vendorPath('resources/views')]); + $finder->addNamespace('hyde', Hyde::vendorPath('resources/views')); + + $view = new Factory($resolver, $finder, new Dispatcher()); + + app()->instance('view', $view); + app()->instance(FactoryContract::class, $view); + } +} 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/resources/assets/app.css b/resources/assets/app.css index dc762b9fd11..42de1227e3f 100644 --- a/resources/assets/app.css +++ b/resources/assets/app.css @@ -5,16 +5,14 @@ * 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 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 */ -@import '~hydefront/dist/hyde.css'; +@import 'hydefront/components/torchlight.css'; @tailwind base; @tailwind components; @tailwind utilities; - -[x-cloak] { display: none !important; } diff --git a/resources/assets/app.js b/resources/assets/app.js index 8081ae9a513..79675e67904 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 app.js file. +* This is the main JavaScript used by Vite to build the app.js file. */ diff --git a/tailwind.config.js b/tailwind.config.js index 9171b63559f..9068a370456 100644 --- a/tailwind.config.js +++ b/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/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 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 -+++ ++++++This is the Vite development server that provides Hot Module Replacement for your HydePHP site.
+Your HydePHP site is running on the Realtime Compiler server.
+HydePHP Realtime Compiler
+The main development server for your HydePHP site.
+HydePHP Dashboard
+Access the realtime compiler dashboard to monitor your site.
++++ Your HydePHP site is running at:
+
+ http://localhost:8080 +Want to learn more about HydePHP?
++ Read the docs → +
++1echo 'Syntax highlighted by torchlight.dev.';--- diff --git a/vite.config.js b/vite.config.js new file mode 100644 index 00000000000..b06ea97180d --- /dev/null +++ b/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]' + } + } + } +}); 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')1echo 'Syntax highlighted by torchlight.dev.'; -
+
+ #
+ Level 2
+
+