docs: Add Livewire 2.x compatibility notice

- Updated CHANGELOG.md with v0.1.2 changes
- Added Livewire compatibility section to README
- Clarified which features work without Livewire 3.x
- Added FAQ section

Author: sindyko

CHANGELOG.md

@@ -2,7 +2,29 @@
 
 All notable changes to `aliaser` will be documented in this file.
 
-## [Released]
+## [0.1.2] - 2025-12-19
+
+### Added
+
+- Automatic Livewire version detection
+- Support for projects without Livewire installed
+
+### Changed
+
+- **Breaking**: Livewire 2.x is temporarily not supported
+- Livewire synthesizers now only register for Livewire 3.x or High
+- Improved service provider registration logic
+
+### Fixed
+
+- Prevented errors when Livewire 2.x is installed
+- Package no longer crashes in projects without Livewire
+
+## [0.1.1] - 2025-12-18
+
+### Fixed
+
+- Minor bug fixes and improvements
 
 ## [0.1.0] - 2025-12-17
 

README.md

@@ -4,6 +4,12 @@
 [![License](https://img.shields.io/packagist/l/sindyko/aliaser.svg?style=flat-square)](https://packagist.org/packages/sindyko/aliaser)
 [![Tests](https://github.com/sindyko/aliaser/actions/workflows/tests.yml/badge.svg)](https://github.com/sindyko/aliaser/actions/workflows/tests.yml)
 
+## Requirements
+
+- PHP ^8.1|^8.2|^8.3
+- Laravel ^10.0|^11.0|^12.0
+- Livewire ^3.0 (optional, for Livewire integration)
+
 # Aliaser 🎭
 
 Elegant alias management for Laravel Eloquent models, Livewire forms, DTOs, collections, and enums. Replace long class
@@ -20,6 +26,24 @@ names with short, memorable aliases throughout your application and Livewire sna
 - 🔒 **Security** - obfuscated class paths in frontend
 - 🧪 **Fully tested** - comprehensive test coverage
 
+## Features
+
+### Core Features (work everywhere)
+
+- 🎯 **Entity Facade** - Access models by alias: `Entity::user(1)` instead of `User::find(1)`
+- 🗺️ **Morph Map Integration** - Automatically sync aliases with Eloquent morph map
+- 📦 **Multiple Registries** - Separate registries for Models, Forms, DTOs, Collections, and Enums
+- 🛠️ **Artisan Commands** - `aliaser:install`, `aliaser:list`, `aliaser:help`
+- 🔧 **Helper Functions** - Convenient `modelsMap()`, `formsMap()`, etc.
+
+### Livewire 3.x Features
+
+- 🚀 **Snapshot Optimization** - Up to 50% smaller Livewire snapshots
+- 🔒 **Hide Internal Structure** - Short aliases instead of full class names in frontend
+- ⚡ **Custom Synthesizers** - Automatic serialization for Models, Collections, Forms, Enums, and DTOs
+
+> **Note**: Livewire features require Livewire 3.x. See [Livewire Compatibility](#livewire-compatibility) for details.
+
 ## 📦 Installation
 
 ```bash
@@ -787,5 +811,57 @@ The MIT License (MIT). Please see [License File](LICENSE.md) for more informatio
 
 ***
 
+### Livewire Compatibility
+
+**Current Status:**
+
+- ✅ **Livewire 3.x** - Fully supported with all features
+- ⚠️ **Livewire 2.x** - Not currently supported (coming soon)
+- ✅ **No Livewire** - Core features work without Livewire
+
+> **Note**: Livewire 2.x support is planned for a future release. Currently, if you have Livewire 2.x installed,
+> Livewire-specific features (snapshot optimization) will be automatically disabled, but all other features will work
+> normally.
+
+#### What works without Livewire 3?
+
+Even without Livewire 3.x (or without Livewire at all), you can use:
+
+- ✅ **Entity facade**: `Entity::user()->where('active', true)->get()`
+- ✅ **Model morph map integration**: Short aliases in database polymorphic relations
+- ✅ **All registries**: Models, Forms, Objects, Collections, Enums
+- ✅ **Artisan commands**: `aliaser:list`, `aliaser:help`, etc.
+
+Only **Livewire snapshot optimization** requires Livewire 3.x.
+
+#### Upgrading to Livewire 3
+
+If you're using Livewire 2.x and want full Aliaser integration:
+
+***
+
+## FAQ
+
+### Does Aliaser work without Livewire?
+
+Yes! Core features like Entity facade, morph map integration, and registries work perfectly without Livewire. Only
+snapshot optimization requires Livewire 3.x.
+
+### I have Livewire 2.x installed. Will Aliaser work?
+
+Yes, but with limited functionality. Aliaser will automatically detect Livewire 2.x and disable Livewire-specific
+features. The Entity facade, registries, and morph map integration will work normally. Livewire 2.x support is planned
+for future releases.
+
+### Why doesn't Aliaser support Livewire 2.x yet?
+
+Livewire 3 introduced a new synthesizer architecture that Aliaser uses for snapshot optimization. Livewire 2 has a
+different internal structure. We're working on backward compatibility and plan to support Livewire 2.x in an upcoming
+release.
+
+### How do I check which version of Livewire I have?
+
+***
+
 Made with ❤️ for the Laravel community
 

src/Providers/AliaserServiceProvider.php

@@ -29,7 +29,7 @@ public function register(): void
         $this->app->alias('entity.manager', EntityManager::class);
         $this->app->alias('entity.registry', ModelRegistry::class);
 
-        if (class_exists(\Livewire\Livewire::class)) {
+        if ($this->isLivewire3Available()) {
             $this->app->register(LivewireSynthServiceProvider::class);
         }
     }
@@ -61,4 +61,25 @@ protected function syncMorphMap(): void
             Relation::enforceMorphMap($map);
         }
     }
+
+    protected function isLivewire3Available(): bool
+    {
+        if (! class_exists(\Livewire\Livewire::class)) {
+            return false;
+        }
+
+        if (class_exists(\Composer\InstalledVersions::class)) {
+            try {
+                $version = \Composer\InstalledVersions::getVersion('livewire/livewire');
+
+                if ($version && version_compare($version, '3.0.0', '>=')) {
+                    return true;
+                }
+            } catch (\Exception $e) {
+                // Fallback
+            }
+        }
+
+        return class_exists(\Livewire\Mechanisms\HandleComponents\Synthesizers\Synth::class);
+    }
 }

src/Providers/LivewireSynthServiceProvider.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Sindyko\Aliaser\Providers;
 
 use Illuminate\Support\ServiceProvider;
@@ -23,24 +25,38 @@ class LivewireSynthServiceProvider extends ServiceProvider
 
     public function boot(): void
     {
-        if (! $this->isLivewireAvailable()) {
+        if (! $this->isLivewireV3OrHigher()) {
             return;
         }
 
         $this->registerSynthesizers();
     }
 
-    protected function isLivewireAvailable(): bool
+    protected function isLivewireV3OrHigher(): bool
     {
-        return class_exists(\Livewire\Livewire::class);
+        if (! class_exists(\Livewire\Livewire::class)) {
+            return false;
+        }
+
+        if (class_exists(\Composer\InstalledVersions::class)) {
+            try {
+                $version = \Composer\InstalledVersions::getVersion('livewire/livewire');
+
+                if ($version && version_compare($version, '3.0.0', '>=')) {
+                    return true;
+                }
+            } catch (\Exception $e) {
+                // Fallback
+            }
+        }
+
+        return class_exists(\Livewire\Mechanisms\HandleComponents\Synthesizers\Synth::class);
     }
 
     protected function registerSynthesizers(): void
     {
         foreach ($this->synthesizers as $synthesizer) {
-            if (class_exists($synthesizer)) {
-                \Livewire\Livewire::propertySynthesizer($synthesizer);
-            }
+            \Livewire\Livewire::propertySynthesizer($synthesizer);
         }
     }
 }