guidelines: livewire: wip

Author: ashleyhindle

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

@@ -1,36 +1,8 @@
-
 #### Key Changes from Livewire 2
+- These changed in Livewire 2, but may not have in this project. Verify this project's setup to ensure you conform with conventions.
 
-- **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
-
-#### Livewire Best Practices
-
-- **Single root element** in Blade components
-- **Add wire:key** in loops:
-
-@verbatim
-```blade
-@foreach ($items as $item)
-    <div wire:key="item-{{ $item->id }}">
-        {{ $item->name }}
-    </div>
-@endforeach
-```
-@endverbatim
-
-- **Use attributes** for event listeners:
-
-```php
-#[On('todo-created')]
-public function refreshList()
-{
-// ...
-}
-```
-
-- **Loading states**: Use `wire:loading` and `wire:dirty`
-- **Confirmations**: Use `wire:confirm="Are you sure?"`
+- **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.

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

@@ -1 +1,17 @@
 ## Livewire Core
+- Use the `search-docs` tool to find exact version specific documentation for how to write Livewire.
+
+
+## Livewire Best Practices
+- **Single root element** in Blade components
+- **Loading states**: Use `wire:loading` and `wire:dirty`.
+- **Add wire:key** in loops:
+@verbatim
+    ```blade
+    @foreach ($items as $item)
+        <div wire:key="item-{{ $item->id }}">
+            {{ $item->name }}
+        </div>
+    @endforeach
+    ```
+@endverbatim

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

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

.ai/livewire/core.blade.php

@@ -1,5 +1,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 project's Tailwind setup.
 - 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"

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

@@ -1,6 +1,7 @@
 - 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
+- Use the `search-docs` tool to find exactly what's supported in this project's Tailwind setup.
 
 ## Spacing
 - Use gap utilities for spacing, don't use margins

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

@@ -107,11 +107,10 @@ public function increment()
 $delete = fn(Product $product) => $product->delete();
 ?>
 
-    <!-- UI here -->
+<!-- HTML here -->
 @endvolt
 </code-snippet>
 @endverbatim
-
 @verbatim
 <code-snippet name="Real-time search with Volt" lang="php">
     <flux:input
@@ -120,8 +119,6 @@ public function increment()
     />
 </code-snippet>
 @endverbatim
-
-
 @verbatim
 <code-snippet name="Loading states with Volt" lang="php">
     <flux:button wire:click="save" wire:loading.attr="disabled">

.ai/tailwindcss/core.blade.php

@@ -16,21 +16,24 @@ class SearchDocs extends Tool
 {
     use MakesHttpRequests;
 
-    public function __construct(protected Roster $roster)
-    {
-    }
+    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 +57,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 +93,7 @@ public function handle(array $arguments): ToolResult|Generator
             'token_limit' => $tokenLimit,
             'format' => 'markdown',
         ];
+
         try {
             $response = $this->client()->asJson()->post($apiUrl, $payload);