Merge branch 'main' into update-home

Author: brendt

src/Markdown/HeadingRenderer.php

@@ -4,14 +4,10 @@
 
 use InvalidArgumentException;
 use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
-use League\CommonMark\Extension\CommonMark\Node\Inline\Code;
-use League\CommonMark\Extension\HeadingPermalink\HeadingPermalink;
-use League\CommonMark\Node\Inline\Text;
 use League\CommonMark\Node\Node;
 use League\CommonMark\Renderer\ChildNodeRendererInterface;
 use League\CommonMark\Renderer\NodeRendererInterface;
 use League\CommonMark\Util\HtmlElement;
-use Tempest\Highlight\Highlighter;
 use Tempest\Support\Str\ImmutableString;
 
 final class HeadingRenderer implements NodeRendererInterface

src/Markdown/LinkRenderer.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Markdown;
+
+use InvalidArgumentException;
+use League\CommonMark\Extension\CommonMark\Node\Inline\Link;
+use League\CommonMark\Extension\CommonMark\Renderer\Inline\LinkRenderer as InlineLinkRenderer;
+use League\CommonMark\Node\Node;
+use League\CommonMark\Renderer\ChildNodeRendererInterface;
+use League\CommonMark\Renderer\NodeRendererInterface;
+use League\CommonMark\Xml\XmlNodeRendererInterface;
+use League\Config\ConfigurationAwareInterface;
+use League\Config\ConfigurationInterface;
+use Tempest\Support\Regex;
+
+final class LinkRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface
+{
+    private ConfigurationInterface $config;
+    
+    public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable
+    {
+        if (! ($node instanceof Link)) {
+            throw new InvalidArgumentException('Node must be instance of ' . Link::class);
+        }
+
+        // Replace .md at the end, before a / or a #
+        $node->setUrl(
+            Regex\replace($node->getUrl(), '/\.md((?=[\/#?])|$)/', '')
+        );
+
+        $renderer = new InlineLinkRenderer;
+        $renderer->setConfiguration($this->config);
+
+        return $renderer->render($node, $childRenderer);
+    }
+
+    public function setConfiguration(ConfigurationInterface $configuration): void
+    {
+        $this->config = $configuration;
+    }
+
+    public function getXmlTagName(Node $node): string
+    {
+        return 'link';
+    }
+
+    public function getXmlAttributes(Node $node): array
+    {
+        if (! ($node instanceof Link)) {
+            throw new InvalidArgumentException('Node must be instance of ' . Link::class);
+        }
+
+        return [
+            'destination' => $node->getUrl(),
+            'title' => $node->getTitle() ?? '',
+        ];
+    }
+}

src/Markdown/MarkdownInitializer.php

@@ -9,10 +9,12 @@
 use App\Markdown\Symbols\AttributeParser;
 use App\Markdown\Symbols\FqcnParser;
 use League\CommonMark\Environment\Environment;
+use League\CommonMark\Extension\Attributes\AttributesExtension;
 use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
 use League\CommonMark\Extension\CommonMark\Node\Block\FencedCode;
 use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
 use League\CommonMark\Extension\CommonMark\Node\Inline\Code;
+use League\CommonMark\Extension\CommonMark\Node\Inline\Link;
 use League\CommonMark\Extension\FrontMatter\FrontMatterExtension;
 use League\CommonMark\MarkdownConverter;
 use Tempest\Container\Container;
@@ -32,13 +34,15 @@ public function initialize(Container $container): MarkdownConverter
         $environment
             ->addExtension(new CommonMarkCoreExtension())
             ->addExtension(new FrontMatterExtension())
+            ->addExtension(new AttributesExtension())
             ->addExtension(new AlertExtension())
             ->addInlineParser(new TempestPackageParser())
             ->addInlineParser(new FqcnParser())
             ->addInlineParser(new AttributeParser())
             ->addInlineParser(new HandleParser())
             ->addRenderer(FencedCode::class, new CodeBlockRenderer($highlighter))
             ->addRenderer(Code::class, new InlineCodeBlockRenderer($highlighter))
+            ->addRenderer(Link::class, new LinkRenderer())
             ->addRenderer(Heading::class, new HeadingRenderer());
 
         return new MarkdownConverter($environment);

src/Web/Blog/BlogController.php

@@ -5,6 +5,7 @@
 use App\Web\Meta\MetaType;
 use DateTimeImmutable;
 use Tempest\Cache\Cache;
+use Tempest\DateTime\DateTime;
 use Tempest\Http\Response;
 use Tempest\Http\Responses\NotFound;
 use Tempest\Http\Responses\Ok;
@@ -47,7 +48,7 @@ public function rss(
         $xml = $cache->resolve(
             key: 'rss',
             cache: fn () => $this->renderRssFeed($repository->all(loadContent: true)),
-            expiresAt: new DateTimeImmutable('+1 hour'),
+            expiresAt: DateTime::now()->plusHours(1),
         );
 
         return new Ok($xml)

src/Web/Documentation/RedirectMiddleware.php

@@ -49,11 +49,6 @@ public function __invoke(Request $request, HttpMiddlewareCallable $next): Respon
             return new Redirect($path->replace("/{$matched->params['version']}/", "/{$version->value}/"));
         }
 
-        // Redirect to docs index if not found
-        if ($response instanceof NotFound) {
-            return new Redirect(uri([ChapterController::class, 'index']));
-        }
-
         return $response;
     }
 }

src/Web/Documentation/content/main/0-getting-started/00-introduction.md

@@ -37,7 +37,7 @@ final readonly class BookController
 }
 ```
 
-The above snippet is an example of a controller controller. It features [attribute-based routes](../1-framework/03-controllers), mapping a request to a data object using the [mapper](../1-framework/11-mapper), [URL generation](../1-framework/03-controllers#generating-uris) and [dependency injection](../1-framework/02-the-container#autowired-dependencies).
+The above snippet is an example of a controller controller. It features [attribute-based routes](../1-essentials/02-controllers), mapping a request to a data object using the [mapper](../2-tempest-in-depth/01-mapper), [URL generation](../1-essentials/02-controllers#generating-uris) and [dependency injection](../1-essentials/01-container#autowired-dependencies).
 
 ```php
 use Tempest\Console\Console;
@@ -83,12 +83,12 @@ final readonly class MigrateUpCommand
 }
 ```
 
-This is a [console command](../2-console/02-building-console-commands). Console commands can be defined in any class, as long as the `#[ConsoleCommand]` attribute is used on a method. Command arguments are defined as the method's arguments, effectively removing the need to learn some specific framework syntax.
+This is a [console command](../3-console/02-building-console-commands). Console commands can be defined in any class, as long as the `#[ConsoleCommand]` attribute is used on a method. Command arguments are defined as the method's arguments, effectively removing the need to learn some specific framework syntax.
 
-This example also shows how to [register events globally](../1-framework/07-events) using the `#[EventHandler]`.
+This example also shows how to [register events globally](../2-tempest-in-depth/03-events) using the `#[EventHandler]`.
 
 ---
 
 :::info Ready to give it a try?
-Keep on reading and consider [**giving Tempest a star️ on GitHub**](https://github.com/tempestphp/tempest-framework). If you want to be part of the community, you can [**join our Discord server**](https://discord.gg/pPhpTGUMPQ), and if you feel like contributing, you can check out our [contributing guide](/docs/internals/contributing)!
+Keep on reading and consider [**giving Tempest a star️ on GitHub**](https://github.com/tempestphp/tempest-framework). If you want to be part of the community, you can [**join our Discord server**](https://discord.gg/pPhpTGUMPQ), and if you feel like contributing, you can check out our [contributing guide](/docs/extra-topics/contributing)!
 :::

src/Web/Documentation/content/main/0-getting-started/01-getting-started.md

@@ -73,7 +73,7 @@ Tempest won't impose any file structure on you: one of its core features is that
 For instance, Tempest is able to differentiate between a controller method and a console command by looking at the code, instead of relying on naming conventions or configuration files.
 
 :::info
-This concept is called [discovery](../3-internals/02-discovery), and is one of Tempest's most powerful features.
+This concept is called [discovery](../4-internals/02-discovery), and is one of Tempest's most powerful features.
 :::
 
 ### Examples

src/Web/Documentation/content/main/1-essentials/02-controllers.md

@@ -479,7 +479,7 @@ final readonly class JsonController
 
 ### Post-processing responses
 
-There are some situations in which you may need to act on a response right before it is sent to the client. For instance, you may want to display custom error error pages when an exception occurred, or redirect somewhere instead of displaying the [built-in HTTP 404](/hello-from-the-void) page.
+There are some situations in which you may need to act on a response right before it is sent to the client. For instance, you may want to display custom error error pages when an exception occurred, or redirect somewhere instead of displaying the [built-in HTTP 404](/hello-from-the-void){:ssg-ignore="true"} page.
 
 This may be done using a response processor. Similar to [view processors](./03-views#pre-processing-views), they are classes that implement the {`Tempest\Response\ResponseProcessor`} interface. In the `process()` method, you may mutate and return the response object:
 

src/Web/Documentation/content/main/2-tempest-in-depth/02-validation.md

@@ -2,7 +2,7 @@
 title: Validation
 ---
 
-Validation with Tempest is done by taking an array of raw input data, and validating whether that array of data is valid against a class. While validation and [data mapping](/main/framework/validation) often work together, the two are separate components and can also be used separately.
+Validation with Tempest is done by taking an array of raw input data, and validating whether that array of data is valid against a class. While validation and [data mapping](./01-mapper) often work together, the two are separate components and can also be used separately.
 
 Here's an object that can be validated:
 
@@ -51,13 +51,13 @@ final class Book
 
     #[NotEmpty]
     public string $description;
-    
+
     #[DateTimeFormat('Y-m-d')]
     public ?DateTimeImmutable $publishedAt = null;
 }
 ```
 
-A list of all available validation rules can be found on [GitHub](https://github.com/tempestphp/tempest-framework/tree/main/src/Tempest/Validation/src/Rules). 
+A list of all available validation rules can be found on [GitHub](https://github.com/tempestphp/tempest-framework/tree/main/src/Tempest/Validation/src/Rules).
 
 ## Skipping Validation
 

src/Web/Documentation/content/main/5-highlight/01-getting-started.md

@@ -84,7 +84,7 @@ The gutter will show additions and deletions, and can start at any given line nu
   }
 ```
 
-Finally, you can enable gutter rendering on the fly if you're using [commonmark code blocks](#commonmark-integration) by appending <code>{startAt}</code> to the language definition:
+Finally, you can enable gutter rendering on the fly if you're using [commonmark code blocks](#common-mark-integration) by appending <code>{startAt}</code> to the language definition:
 
 <pre>
 &#96;&#96;&#96;php{10}
@@ -194,7 +194,7 @@ Within inline Markdown code tags, you can specify the language by prepending it
 &#96;{php}public function before(TokenType $tokenType): string&#96;
 </pre>
 
-You'll need to set up [commonmark](#commonmark-integration) properly to get this to work.
+You'll need to set up [commonmark](#common-mark-integration) properly to get this to work.
 
 ## CommonMark integration