wip

Author: brendt

src/Web/Blog/BlogPostTag.php

@@ -4,9 +4,9 @@
 
 enum BlogPostTag: string
 {
-    case RELEASE = 'Release';
-    case THOUGHTS = 'Thoughts';
-    case TUTORIAL = 'Tutorial';
+    case RELEASE = 'release';
+    case THOUGHTS = 'thoughts';
+    case TUTORIAL = 'tutorial';
 
     public function getStyle(): string
     {

src/Web/Blog/BlogRepository.php

@@ -36,6 +36,14 @@ public function all(bool $loadContent = false): ImmutableArray
                     ...YamlFrontMatter::parse(file_get_contents($path))->matter(),
                 ];
 
+                if (isset($data['tag'])) {
+                    $data['tag'] = strtolower($data['tag']);
+                }
+
+                if (isset($data['author'])) {
+                    $data['author'] = strtolower($data['author']);
+                }
+
                 if ($loadContent) {
                     $data['content'] = $this->parseContent($path)->getContent();
                 }
@@ -63,6 +71,14 @@ public function find(string $slug): ?BlogPost
             ...$content->getFrontMatter(),
         ];
 
+        if (isset($data['tag'])) {
+            $data['tag'] = strtolower($data['tag']);
+        }
+
+        if (isset($data['author'])) {
+            $data['author'] = strtolower($data['author']);
+        }
+
         return map($data)->to(BlogPost::class);
     }
 

src/Web/Blog/articles/2025-07-29-tempest-1-5.md

@@ -0,0 +1,91 @@
+---
+title: Tempest 1.5
+description: This release brings a new markdown view component, CSRF support, installable view components, and more.
+tag: release
+author: brent
+---
+
+## Installable view components
+
+We made some pretty significant changes to view component's discovery. These changes now make it possible to ship view components from the framework or via third-party packages and publish them when needed:
+
+```console
+./tempest install view-components
+
+ <dim>│</dim> <em>Select which view components you want to install</em>
+ <dim>│</dim> / <dim>Filter...</dim>
+ <dim>│</dim> → ⋅ x-csrf-token
+ <dim>│</dim>   ⋅ x-markdown
+ <dim>│</dim>   ⋅ x-input
+ <dim>│</dim>   ⋅ x-icon
+ 
+<comment>…</comment>
+```
+
+This refactor came with some breaking changes though. Tempest View is still an experimental component of the framework, so occasional breaking changes might happen. We documented the how and why of these changes in [a separate blog post](/blog/tempest-view-updates). In the end, these changes made a lot of sense, and it's great to see how [Discovery](/blog/discovery-explained) made the installer part with vendor- and project-based view components trivial to add. 
+
+Apart from the view component installer, we also made a bunch of fixes to how view components deal with local and global variable scope, and we added a bunch more built-in view components that ship with the framework:
+
+- `{html}<x-base />`: a barebone base layout with Tailwind CDN included
+- `{html}<x-form />`: a form component which posts by default and includes the csrf token out of the box
+- `{html}<x-input />`: a flexible component to render form inputs
+- `{html}<x-submit />`: renders a submit button
+- `{html}<x-markdown />`: a component to render markdown, either inline or from a variable
+
+You can read more about built-in view components in [the docs](/docs/essentials/views#built-in-components).
+
+## CSRF support
+
+Any form request will now have CSRF protection. Because CSRF protection is enabled by default, you will need to add the new `{html}<x-csrf-token />` element to your forms (it is included by default when you use `{html}<x-form />`).
+
+```html
+<form action="…">
+    <x-csrf-token />
+</form>
+```
+
+## Database pagination
+
+The select query builder now has pagination support:
+
+```php
+$chapters = query(Chapter::class)
+    ->select()
+    ->whereField('book_id', $book->id)
+    ->paginate();
+```
+
+## New `Json` response
+
+We've added a new `Json` response class that can be returned from controllers and will include the necessary JSON headers:
+
+```php
+use Tempest\Http\Responses\Json;
+
+#[Get('/books')]
+public function books(): Response
+{
+    // …
+    return new Json($books);
+}
+```
+
+## View data testers
+
+We added some additional assertion methods to our HTTP tester, so that you can make assertions on view data directly:
+
+```php
+public function test_can_assert_view_data(): void
+{
+    $this->http
+        ->get(uri([TestController::class, 'withView']))
+        ->assertViewData('name')
+        ->assertViewData('name', function (array $data, string $value): void {
+            $this->assertEquals(['name' => 'Brent'], $data);
+            $this->assertEquals('Brent', $value);
+        })
+        ->assertViewDataMissing('email');
+}
+```
+
+That's all the notable new features in Tempest 1.5. Of course, there are a bunch of bug fixes as well. Click here to read [the full changelog](https://github.com/tempestphp/tempest-framework/releases/tag/v1.5.0).  

src/Web/Blog/index.view.php

@@ -1,6 +1,7 @@
 <?php
 
 /** @var \App\Web\Blog\BlogPost[] $posts */
+use function Tempest\Support\str;
 ?>
 
 <x-base title="Blog">
@@ -35,7 +36,7 @@
 							:class="$post->tag->getStyle()"
 							class="font-medium inline-flex items-center text-xs px-2 py-1 gap-1 rounded ring ring-inset"
 						>
-							{{ $post->tag->value }}
+							{{ str($post->tag->value)->title() }}
 						</span>
 						<span :if="$post->author" class="text-(--ui-text-muted) text-sm">
 							by <span class="font-medium">{{ $post->author->getName() }}</span> on <span class="font-medium">{{ $post->createdAt->format('F d, Y') }}</span>

src/Web/Documentation/content/1.x/1-essentials/02-views.md

@@ -485,7 +485,7 @@ A base template you can install into your own project as a starting point. This
 
 ### `x-form`
 
-This component provides a form element that will post by default instead of get:
+This component provides a form element that will post by default and includes the csrf token out of the box:
 
 ```html
 <?php
@@ -516,6 +516,16 @@ A submit button component that prefills with a "Submit" label:
 <x-submit label="Send" />
 ```
 
+### `x-csrf-token`
+
+Includes the CSRF token in a form
+
+```html
+<form action="…">
+    <x-csrf-token />
+</form>
+```
+
 ### `x-icon`
 
 This component provides the ability to inject any icon from the [Iconify](https://iconify.design/) project in your templates.

src/Web/Documentation/content/1.x/4-internals/03-view-spec.md

@@ -470,7 +470,7 @@ A base template you can install into your own project as a starting point. This
 
 ### `x-form`
 
-This component provides a form element that will post by default instead of get:
+This component provides a form element that will post by default and includes the csrf token out of the box:
 
 ```html
 <?php
@@ -501,6 +501,16 @@ A submit button component that prefills with a "Submit" label:
 <x-submit label="Send" />
 ```
 
+### `x-csrf-token`
+
+Includes the CSRF token in a form
+
+```html
+<form action="…">
+    <x-csrf-token />
+</form>
+```
+
 ### `x-icon`
 
 This component provides the ability to inject any icon from the [Iconify](https://iconify.design/) project in your templates.