Update docs, add translations and helpers

Author: jyrkidn

composer.json

@@ -16,9 +16,9 @@
         "spatie/laravel-package-tools": "^1.12"
     },
     "require-dev": {
+        "larastan/larastan": "^2.0",
         "laravel/pint": "^1.0",
         "nunomaduro/collision": "^7.0 || ^8.0",
-        "nunomaduro/larastan": "^2.0",
         "orchestra/testbench": "^8.0 || ^9.0",
         "pestphp/pest": "^2.0",
         "pestphp/pest-plugin-laravel": "^2.0",
@@ -30,7 +30,10 @@
         "psr-4": {
             "Wotz\\FilamentLivePreview\\": "src",
             "Wotz\\FilamentLivePreview\\Database\\Factories\\": "database/factories"
-        }
+        },
+        "files": [
+            "src/helpers.php"
+        ]
     },
     "autoload-dev": {
         "psr-4": {

docs/index.md

@@ -38,7 +38,7 @@ php artisan vendor:publish --tag="filament-live-preview-views"
 
 Follow the Laravel Reverb installation instructions [here](https://laravel.com/docs/12.x/reverb)
 
-#### Fix Livewire and Reverb
+#### Fix Livewire and Websockets
 
 In `bootstrap/app.php`, add the following lines:
 
@@ -199,3 +199,19 @@ In `routes/channels.php`, add the following line:
 ```php
 Broadcast::channel('live-preview', function () {});
 ```
+
+#### Blade files
+
+If you load a blade file which loads a Livewire component, it wil break the live preview for some unknown reason.
+
+This can be fixed by wrapping the Livewire component in a conditional, like this:
+
+```blade
+@if (! is_live_preview_request())
+    <livewire:filters />
+@else
+    {{ __('filament-live-preview::alert.preview unavailable for :name', [
+        'name' => "filters"
+    ]) }}
+@endif
+```

phpstan.neon.dist

@@ -2,13 +2,10 @@ includes:
     - phpstan-baseline.neon
 
 parameters:
-    level: 4
+    level: 5
     paths:
         - src
         - config
-        - database
     tmpDir: build/phpstan
     checkOctaneCompatibility: true
     checkModelProperties: true
-    checkMissingIterableValueType: false
-

resources/lang/en/alert.php

@@ -0,0 +1,5 @@
+<?php
+
+return [
+    'preview unavailable for :name' => 'Preview unavailable for :name',
+];

resources/lang/nl/alert.php

@@ -0,0 +1,5 @@
+<?php
+
+return [
+    'preview unavailable for :name' => 'Preview onbeschikbaar voor :name',
+];

src/Livewire/LivePreviewScreen.php

@@ -15,7 +15,9 @@ class LivePreviewScreen extends Component
 
     public function mount()
     {
-        abort_unless($this->token = request()->query('token'), 404);
+        $this->token = request()->query('token');
+
+        abort_unless(filled($this->token), 404);
 
         $this->refreshPreview();
     }

src/Providers/FilamentLivePreviewServiceProvider.php

@@ -13,6 +13,7 @@ public function configurePackage(Package $package): void
             ->name('filament-live-preview')
             ->setBasePath(__DIR__ . '/../')
             ->hasConfigFile()
+            ->hasTranslations()
             ->hasRoute('web')
             ->hasViews();
     }

src/helpers.php

@@ -0,0 +1,20 @@
+<?php
+
+if (! function_exists('is_live_preview_request')) {
+    function is_live_preview_request(): bool
+    {
+        if (request()->routeIs('live-preview-frame')) {
+            return true;
+        }
+
+        if (app('livewire')->isLivewireRequest()) {
+            $snapshot = json_decode(request('components.0.snapshot'), true);
+
+            if (($snapshot['memo']['name'] ?? '') === 'filament-live-preview::live-preview-screen') {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}