Adds @once directive as a validation check & extra test cases

src/Exceptions/InvalidPureUsageException.php

@@ -100,4 +100,13 @@ public static function forOld(string $componentPath): self
         );
     }
 
+    public static function forOnce(string $componentPath): self
+    {
+        return new self(
+            $componentPath,
+            '@once',
+            'Components with @once should not use @pure as @once maintains runtime state'
+        );
+    }
+
 }

src/Folder/Folder.php

@@ -127,6 +127,7 @@ protected function validatePureComponent(string $source, string $componentPath):
     {
         $problematicPatterns = [
             '@aware' => 'forAware',
+            '@once' => 'forOnce',
             '\\$errors' => 'forErrors',
             'session\\(' => 'forSession',
             '@error\\(' => 'forError',

tests/BlazeTest.php

@@ -51,7 +51,7 @@
     });
 
     it('throws exception for components with invalid pure usage', function () {
-        expect(fn() => \Illuminate\Support\Facades\Blade::render('<x-invalid-pure>Test</x-invalid-pure>'))
+        expect(fn() => \Illuminate\Support\Facades\Blade::render('<x-invalid-pure.errors>Test</x-invalid-pure.errors>'))
             ->toThrow(\Livewire\Blaze\Exceptions\InvalidPureUsageException::class);
     });
 
@@ -66,4 +66,4 @@
         expect($rendered)->not->toContain('<x-card>');
     });
 
-});
+});

tests/FoldTest.php

@@ -117,20 +117,31 @@ function compile(string $input): string {
         expect(compile($input))->toBe($output);
     });
 
-    it('throws exception for invalid @pure usage', function () {
-        // Test the folder validation directly
+    it('throws exception for invalid pure usage with $pattern', function (string $pattern, string $expectedPattern) {
         $folder = app('blaze')->folder();
-        $componentNode = new \Livewire\Blaze\Nodes\ComponentNode('invalid-pure', 'x', '', [], false);
+        $componentNode = new \Livewire\Blaze\Nodes\ComponentNode("invalid-pure.{$pattern}", 'x', '', [], false);
+
+        expect(fn() => $folder->fold($componentNode))
+            ->toThrow(\Livewire\Blaze\Exceptions\InvalidPureUsageException::class);
 
         try {
             $folder->fold($componentNode);
-            expect(false)->toBeTrue('Exception should have been thrown');
         } catch (\Livewire\Blaze\Exceptions\InvalidPureUsageException $e) {
             expect($e->getMessage())->toContain('Invalid @pure usage');
-            expect($e->getComponentPath())->toContain('invalid-pure.blade.php');
-            expect($e->getProblematicPattern())->toBe('\\$errors');
+            expect($e->getComponentPath())->toContain("invalid-pure/{$pattern}.blade.php");
+            expect($e->getProblematicPattern())->toBe($expectedPattern);
         }
-    });
+    })->with([
+        ['aware', '@aware'],
+        ['errors', '\\$errors'],
+        ['session', 'session\\('],
+        ['error', '@error\\('],
+        ['csrf', '@csrf'],
+        ['auth', 'auth\\(\\)'],
+        ['request', 'request\\(\\)'],
+        ['old', 'old\\('],
+        ['once', '@once'],
+    ]);
 
     it('named slots', function () {
         $input = '<x-modal>
@@ -222,4 +233,5 @@ function compile(string $input): string {
 
         expect(compile($input))->toBe($output);
     });
+
 });

tests/fixtures/components/invalid-pure/auth.blade.php

@@ -0,0 +1,5 @@
+@pure
+
+<div>
+    Welcome, {{ auth()->user()->name }}
+</div>

tests/fixtures/components/invalid-pure/aware.blade.php

@@ -0,0 +1,7 @@
+@pure
+
+@aware(['variant' => 'default'])
+
+<div class="item item-{{ $variant }}">
+    {{ $slot }}
+</div>

tests/fixtures/components/invalid-pure/csrf.blade.php

@@ -0,0 +1,6 @@
+@pure
+
+<form method="POST">
+    @csrf
+    {{ $slot }}
+</form>

tests/fixtures/components/invalid-pure/error.blade.php

@@ -0,0 +1,9 @@
+@pure
+
+@props(['name'])
+
+<div>
+    @error($name)
+        <span class="error">{{ $message }}</span>
+    @enderror
+</div>

tests/fixtures/components/invalid-pure.blade.php → tests/fixtures/components/invalid-pure/errors.blade.php

@@ -1,4 +1,5 @@
 @pure
+
 <div class="{{ $errors->has('name') ? 'error' : '' }}">
     {{ $slot }}
-</div>
+</div>

tests/fixtures/components/invalid-pure/old.blade.php

@@ -0,0 +1,3 @@
+@pure
+
+<input type="text" name="email" value="{{ old('email') }}" />

tests/fixtures/components/invalid-pure/once.blade.php

@@ -0,0 +1,10 @@
+@pure
+
+@props(['title'])
+
+<div class="test-component">
+    <h1>{{ $title }}</h1>
+    @once
+        <script>console.log('This should only run once');</script>
+    @endonce
+</div>

tests/fixtures/components/invalid-pure/request.blade.php

@@ -0,0 +1,5 @@
+@pure
+
+<div>
+    Current URL: {{ request()->url() }}
+</div>

tests/fixtures/components/invalid-pure/session.blade.php

@@ -0,0 +1,5 @@
+@pure
+
+<div class="message">
+    {{ session('message') }}
+</div>