fix conflicts

Author: taylorotwell

.ai/livewire/2/core.blade.php

@@ -0,0 +1,16 @@
+- `wire:model` is live by default.
+- **Namespace**: Components typically exist in `App\Http\Livewire`.
+- **Events**: Use `emit()`, `emitTo()`, `emitSelf()` and `dispatchBrowserEvent()` for events.
+- Alpine is included separately to Livewire.
+- You can listen for `livewire:load` to hook into Livewire initialization, and `Livewire.onPageExpired` for when the page expires:
+@verbatim
+<code-snippet name="livewire:load example" lang="js">
+document.addEventListener('livewire:load', function () {
+    Livewire.onPageExpired(() => {
+        alert('Your session expired');
+    });
+
+    Livewire.onError(status => console.error(status));
+});
+</code-snippet>
+@endverbatim

.ai/livewire/3/core.blade.php

@@ -1,37 +1,33 @@
 ## Livewire 3
 
 ### Key Changes From Livewire 2
+- These things changed in Livewire 2, but may not have been updated in this application. Verify this application's setup to ensure you conform with application conventions.
+    - Use `wire:model.live` for real-time updates, `wire:model` is now deferred by default.
+    - Components now use the `App\Livewire` namespace (not `App\Http\Livewire`).
+    - Use `$this->dispatch()` to dispatch events (not `emit` or `dispatchBrowserEvent`).
+    - Use the `components.layouts.app` view as the typical layout path (not `layouts.app`).
 
-- **Namespace**: Components now use `App\Livewire` (not `App\Http\Livewire`).
-- **Events**: Use `$this->dispatch()` (not `emit` or `dispatchBrowserEvent`).
-- **Layout Path**: `components.layouts.app` (not `layouts.app`).
-- **Deferred by Default**: Use `wire:model.live` for real-time updates.
-- **Alpine Included**: Don't manually include Alpine.js.
+### New Directives
+- `wire:show`, `wire:transition`, `wire:cloak, `wire:offline`, `wire:target` are available for use. Use the documentation to find usage examples.
 
-### Livewire Best Practices
-
-- Always use a **single root element** in Blade components.
-- Always add `wire:key` in loops to prevent DOM merging errors.
+### Alpine
+- Alpine is now included with Livewire, don't manually include Alpine.js.
+- Plugins included with Alpine: persist, intersect, collapse, and focus.
 
+### Lifecycle Hooks
+- You can listen for `livewire:init` to hook into Livewire initialization, and `fail.status === 419` for the page expiring:
 @verbatim
-```blade
-@foreach ($items as $item)
-    <div wire:key="item-{{ $item->id }}">
-        {{ $item->name }}
-    </div>
-@endforeach
-```
+<code-snippet name="livewire:load example" lang="js">
+document.addEventListener('livewire:init', function () {
+    Livewire.hook('request', ({ fail }) => {
+        if (fail && fail.status === 419) {
+            alert('Your session expired');
+        }
+    });
+
+    Livewire.hook('message.failed', (message, component) => {
+        console.error(message);
+    });
+});
+</code-snippet>
 @endverbatim
-
-- Use attributes to configure Livewire event listeners:
-
-```php
-#[On('todo-created')]
-public function refreshList()
-{
-// ...
-}
-```
-
-- Use `wire:loading` and `wire:dirty` to configure loading states when applicable.
-- Use something like `wire:confirm="Are you sure?"` to confirm destructive actions.

.ai/tailwindcss/3/.gitkeep .ai/livewire/4/.gitkeep.ai/tailwindcss/3/.gitkeep renamed to .ai/livewire/4/.gitkeep

@@ -1 +1,44 @@
 ## Livewire Core
+- Use the `search-docs` tool to find exact version specific documentation for how to write Livewire & Livewire tests.
+- Use the `php artisan make:livewire [Posts\\CreatePost]` artisan command to create new components
+- State should live on the server, with the UI reflecting it.
+- All Livewire requests hit the Laravel backend, they're like regular HTTP requests. Always validate form data, and run authorization checks in Livewire actions.
+
+## Livewire Best Practices
+- Livewire components require a single root element.
+- Use `wire:loading` and `wire:dirty` for delightful loading states.
+- Add `wire:key` in loops:
+@verbatim
+    ```blade
+    @foreach ($items as $item)
+        <div wire:key="item-{{ $item->id }}">
+            {{ $item->name }}
+        </div>
+    @endforeach
+    ```
+@endverbatim
+- Prefer lifecycle hooks like `mount()`, `updatedFoo()`) for initialization and reactive side effects:
+@verbatim
+<code-snippet name="Lifecycle hook examples" lang="php">
+    public function mount(User $user) { $this->user = $user; }
+    public function updatedSearch() { $this->resetPage(); }
+</code-snippet>
+@endverbatim
+
+## Testing Livewire
+@verbatim
+<code-snippet name="Example Livewire component test" lang="php">
+    Livewire::test(Counter::class)
+        ->assertSet('count', 0)
+        ->call('increment')
+        ->assertSet('count', 1)
+        ->assertSee(1)
+        ->assertStatus(200);
+</code-snippet>
+@endverbatim
+@verbatim
+    <code-snippet name="Testing a Livewire component exists within a page" lang="php">
+        $this->get('/posts/create')
+        ->assertSeeLivewire(CreatePost::class);
+    </code-snippet>
+@endverbatim

.ai/livewire/core.blade.php

@@ -1,4 +1,3 @@
 ## Tailwind 3
 
 - Always use Tailwind CSS v3 - verify you're using only classes supported by this version.
-- Use the `search-docs` tool to find exactly what's supported in this application's Tailwind setup.

.ai/tailwindcss/3/core.blade.php

@@ -1,17 +1,16 @@
 ## Tailwind 4
 
 - Always use Tailwind CSS v4 - do not use the deprecated utilities.
-- Use the `search-docs` tool to find exactly what's supported in this application's Tailwind setup.
+- `corePlugins` is not supported in Tailwind v4.
 - In Tailwind v4, you import Tailwind using a regular CSS `@import` statement, not using the `@tailwind` directives used in v3:
 @verbatim
-<code-snippet name="Tailwind v4 import tailwind diff" lang="diff"
+<code-snippet name="Tailwind v4 Import Tailwind Diff" lang="diff"
    - @tailwind base;
    - @tailwind components;
    - @tailwind utilities;
    + @import "tailwindcss";
 </code-snippet>
 @endverbatim
-- `corePlugins` is not supported in Tailwind v4.
 
 ### Replaced Utilities
 - Tailwind v4 removed deprecated utilities. Do not use the deprecated option - use the replacement.

.ai/tailwindcss/4/.gitkeep

@@ -1,8 +1,8 @@
 ## Tailwind Core
 
-- Use Tailwind CSS classes to style HTML. Check and use existing Tailwind conventions within the project before writing your own.
-- Offer to extract repeated patterns into components that match the project's conventions (i.e. Blade, JSX, Vue, etc.).
-- Think through class placement, order, priority, and defaults - remove redundant classes, add classes to parent or child carefully to limit repetition, and group elements logically.
+- Use Tailwind CSS classes to style HTML, check and use existing tailwind conventions within the project before writing your own.
+- Offer to extract repeated patterns into components that match the project's conventions (i.e. Blade, JSX, Vue, etc..)
+- Think through class placement, order, priority, and defaults - remove redundant classes, add classes to parent or child carefully to limit repetition, group elements logically
 
 ### Spacing
 - When listing items, use gap utilities for spacing, don't use margins.

.ai/tailwindcss/4/core.blade.php

@@ -1,7 +1,8 @@
 ## Livewire Volt
 
 - This project uses Livewire Volt for interactivity within its pages. New pages requiring interactivity must also use Livewire Volt. There is documentation available for it.
-- Volt is an elegantly crafted **class-based** and **functional** API for Livewire that supports single-file components, allowing a component's PHP logic and Blade templates to co-exist in the same file
+- Make new Volt components using `php artisan make:volt [name] [--test] [--pest]`
+- Volt is a **class-based** and **functional** API for Livewire that supports single-file components, allowing a component's PHP logic and Blade templates to co-exist in the same file
 - Livewire Volt allows PHP logic and Blade templates in one file. Components use the `@volt` directive.
 - You must check existing Volt components to determine if they're functional or class based. If you can't detect that, ask the user which they prefer before writing a Volt component.
 
@@ -94,7 +95,8 @@ public function increment()
 
 @verbatim
 <code-snippet name="CRUD With Volt" lang="php">
-@volt
+<?php
+
 use App\Models\Product;
 use function Livewire\Volt\{state, computed};
 
@@ -106,15 +108,15 @@ public function increment()
 
 $edit = fn(Product $product) => $this->editing = $product->id;
 $delete = fn(Product $product) => $product->delete();
+
 ?>
-@endvolt
 
-<!-- UI here -->
+<!-- HTML / UI Here -->
 </code-snippet>
 @endverbatim
 
 @verbatim
-<code-snippet name="Real-time Search With Volt" lang="php">
+<code-snippet name="Real-Time Search With Volt" lang="php">
     <flux:input
         wire:model.live.debounce.300ms="search"
         placeholder="Search..."

.ai/tailwindcss/core.blade.php

@@ -22,15 +22,20 @@ public function __construct(protected Roster $roster)
 
     public function description(): string
     {
-        return 'Search for up-to-date version-specific documentation related to this project and its packages. This tool will search Laravel hosted documentation based on the packages installed and is perfect for all Laravel related packages. Laravel, inertia, pest, livewire, filament, nova, nightwatch, and more.'.PHP_EOL.'You must use this tool to search for Laravel-ecosystem docs before using other approaches.';
+        return 'Search for up-to-date version-specific documentation related to this project and its packages. This tool will search Laravel hosted documentation based on the packages installed and is perfect for all Laravel related packages. Laravel, inertia, pest, livewire, filament, nova, nightwatch, and more.'.PHP_EOL.'You must use this tool to search for Laravel-ecosystem docs before using other approaches. The results provided are for this project\'s package version and does not cover all versions of the package.';
     }
 
     public function schema(ToolInputSchema $schema): ToolInputSchema
     {
         return $schema
-            ->string('queries')
-            ->description('### separated list of queries to perform. Useful to pass multiple if you aren\'t sure if it is "toggle" or "switch", or "infinite scroll" or "infinite load", for example.')->required()
-
+            ->raw('queries', [
+                'description' => 'List of queries to perform, pass multiple if you aren\'t sure if it is "toggle" or "switch", for example',
+                'type' => 'array',
+                'items' => [
+                    'type' => 'string',
+                    'description' => 'Search query',
+                ],
+            ])->required()
             ->raw('packages', [
                 'description' => 'Package names to limit searching to from application-info. Useful if you know the package(s) you need. i.e. laravel/framework, inertiajs/inertia-laravel, @inertiajs/react',
                 'type' => 'array',
@@ -54,7 +59,7 @@ public function handle(array $arguments): ToolResult|Generator
         $packagesFilter = array_key_exists('packages', $arguments) ? $arguments['packages'] : null;
 
         $queries = array_filter(
-            array_map('trim', explode('###', $arguments['queries'])),
+            array_map('trim', $arguments['queries']),
             fn ($query) => $query !== '' && $query !== '*'
         );
 
@@ -90,6 +95,7 @@ public function handle(array $arguments): ToolResult|Generator
             'token_limit' => $tokenLimit,
             'format' => 'markdown',
         ];
+
         try {
             $response = $this->client()->asJson()->post($apiUrl, $payload);