initial release

Author: Mohammad Arif

.github/workflows/release.yml

@@ -14,6 +14,10 @@ jobs:
       matrix:
         php: [8.1, 8.2, 8.3]
         laravel: [10, 11]
+        exclude:
+          # Laravel 11 requires PHP 8.2+
+          - php: 8.1
+            laravel: 11
 
     steps:
       - name: Checkout code

.github/workflows/tests.yml

@@ -22,6 +22,10 @@ jobs:
             testbench: 8.*
           - laravel: 11
             testbench: 9.*
+        exclude:
+          # Laravel 11 requires PHP 8.2+
+          - php: 8.1
+            laravel: 11
 
     steps:
       - name: Checkout code

CONTRIBUTING.md

@@ -36,10 +36,16 @@ composer format
 
 1. Fork the repository
 2. Clone your fork locally
-3. Install dependencies:
+3. **Run the setup script** (recommended):
+   ```bash
+   ./setup.sh
+   ```
+   
+   Or manually install dependencies:
    ```bash
    composer install
    ```
+
 4. Create a feature branch:
    ```bash
    git checkout -b feature/your-feature-name
@@ -56,6 +62,14 @@ composer format
 8. Commit and push
 9. Create a Pull Request
 
+### PHP Version Compatibility
+
+This package supports:
+- **PHP 8.1** with **Laravel 10** 
+- **PHP 8.2+** with **Laravel 10 or 11**
+
+The `setup.sh` script automatically detects your PHP version and installs compatible dependencies.
+
 ## Reporting Issues
 
 When creating an issue, please provide:

composer.json

@@ -15,7 +15,15 @@
     "require": {
         "php": "^8.1",
         "filament/filament": "^3.0",
-        "illuminate/support": "^10.0|^11.0"
+        "illuminate/support": "^10.0|^11.0",
+        "laravel/framework": "^10.0",
+        "orchestra/testbench": "^8.0"
+    },
+    "require-dev": {
+        "laravel/pint": "^1.0",
+        "phpunit/phpunit": "^10.0|^11.0",
+        "pestphp/pest": "^2.0",
+        "pestphp/pest-plugin-laravel": "^2.0"
     },
     "autoload": {
         "psr-4": {

phpunit.xml

@@ -12,10 +12,7 @@
             <directory suffix="Test.php">./tests</directory>
         </testsuite>
     </testsuites>
-    <coverage includeUncoveredFiles="true"
-              processUncoveredFiles="true"
-              ignoreDeprecatedCodeUnits="true"
-              disableCodeCoverageIgnore="true">
+    <coverage>
         <include>
             <directory suffix=".php">./src</directory>
         </include>
@@ -27,5 +24,7 @@
     <php>
         <env name="APP_ENV" value="testing"/>
         <env name="APP_KEY" value="base64:2fl+Ktvkfl+Fuz4Qp/A75G2RTiWVA/ZoKZvp6fiiM10="/>
+        <env name="DB_CONNECTION" value="sqlite"/>
+        <env name="DB_DATABASE" value=":memory:"/>
     </php>
 </phpunit>

setup.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+# Local development setup script for Filament AlertBox Package
+
+set -e
+
+echo "🚀 Setting up Filament AlertBox Package for development..."
+
+# Check PHP version
+PHP_VERSION=$(php -r "echo PHP_VERSION;")
+echo "📋 Detected PHP version: $PHP_VERSION"
+
+# Determine Laravel version based on PHP version
+if php -r "exit(version_compare(PHP_VERSION, '8.2.0', '<') ? 1 : 0);"; then
+    echo "⚠️  PHP < 8.2 detected, using Laravel 10"
+    LARAVEL_VERSION="^10.0"
+    TESTBENCH_VERSION="^8.0"
+else
+    echo "✅ PHP >= 8.2 detected, using Laravel 11"
+    LARAVEL_VERSION="^11.0"
+    TESTBENCH_VERSION="^9.0"
+fi
+
+echo "📦 Installing dependencies..."
+
+# Install dependencies with appropriate versions
+composer require "laravel/framework:$LARAVEL_VERSION" "orchestra/testbench:$TESTBENCH_VERSION" --no-interaction --no-update
+
+echo "🔄 Updating all dependencies..."
+composer update --prefer-dist --no-interaction
+
+echo "✅ Setup complete!"
+echo ""
+echo "Available commands:"
+echo "  composer test          - Run tests"
+echo "  composer format        - Format code with Pint"
+echo "  composer test-coverage - Run tests with coverage"
+echo ""
+echo "🎉 Happy coding!"

src/AlertBoxManager.php

@@ -6,11 +6,10 @@
 
 /**
  * Alert Box Manager
- * 
+ *
  * Manages alerts in memory for FilamentPHP using render hooks system.
  * Provides a fluent API for creating and managing alerts across different page positions.
- * 
- * @package RifRocket\FilamentAlertBox
+ *
  * @author Mohammad Arif <mohammad.arif9999@gmail.com>
  */
 final class AlertBoxManager
@@ -60,11 +59,11 @@ public static function addAlert(string $position, array $config): void
         }
 
         // Validate required config fields
-        if (!isset($config['type']) || !in_array($config['type'], ['info', 'success', 'warning', 'danger', 'error'])) {
+        if (! isset($config['type']) || ! in_array($config['type'], ['info', 'success', 'warning', 'danger', 'error'])) {
             throw new \InvalidArgumentException('Invalid alert type');
         }
 
-        if (!isset(self::$alerts[$position])) {
+        if (! isset(self::$alerts[$position])) {
             self::$alerts[$position] = [];
         }
 
@@ -96,15 +95,15 @@ public static function getAlerts(?string $position = null): array
      */
     public static function getPositionsWithAlerts(): array
     {
-        return array_keys(array_filter(self::$alerts, fn($alerts) => !empty($alerts)));
+        return array_keys(array_filter(self::$alerts, fn ($alerts) => ! empty($alerts)));
     }
 
     /**
      * Check if a position has alerts
      */
     public static function hasAlerts(string $position): bool
     {
-        return !empty(self::$alerts[$position]);
+        return ! empty(self::$alerts[$position]);
     }
 
     /**
@@ -136,7 +135,7 @@ public static function clearAll(): void
     }
 
     // Quick static methods for common patterns (backwards compatibility)
-    
+
     /**
      * Create a success alert
      */

src/AlertBoxPlugin.php

@@ -10,6 +10,7 @@
 class AlertBoxPlugin implements Plugin
 {
     protected bool $enabled = true;
+
     public string $view = 'alert-box::layouts.unified-alert';
 
     public function getId(): string
@@ -19,7 +20,7 @@ public function getId(): string
 
     public function register(Panel $panel): void
     {
-        if (!$this->enabled) {
+        if (! $this->enabled) {
             return;
         }
 
@@ -62,7 +63,7 @@ function () use ($hook) {
                         'position' => $hook, // Pass position to help determine layout type
                     ]);
                 },
-                
+
             );
         }
     }
@@ -73,6 +74,7 @@ function () use ($hook) {
     public function enabled(bool $enabled = true): static
     {
         $this->enabled = $enabled;
+
         return $this;
     }
 
@@ -81,7 +83,8 @@ public function enabled(bool $enabled = true): static
      */
     public function disable(bool $disable = true): static
     {
-        $this->enabled = !$disable;
+        $this->enabled = ! $disable;
+
         return $this;
     }
 
@@ -90,7 +93,7 @@ public function disable(bool $disable = true): static
      */
     public static function make(): static
     {
-        return new static();
+        return new static;
     }
 
     /**
@@ -99,37 +102,38 @@ public static function make(): static
     public function view(string $view): self
     {
         $this->view = $view;
+
         return $this;
     }
 
-
     /**
      * Define default colors for alert types
      */
     public function defineColors(array $colors = []): self
     {
         Config::set('alert-box.colors', $colors ?: [
             'success' => [
-                'title'       => '#047857',
+                'title' => '#047857',
                 'description' => '#10b981',
-                'icon'        => '#10b981',
+                'icon' => '#10b981',
             ],
             'danger' => [
-                'title'       => '#b91c1c',
+                'title' => '#b91c1c',
                 'description' => '#ef4444',
-                'icon'        => '#ef4444',
+                'icon' => '#ef4444',
             ],
             'warning' => [
-                'title'       => '#b45309',
+                'title' => '#b45309',
                 'description' => '#f59e0b',
-                'icon'        => '#f59e0b',
+                'icon' => '#f59e0b',
             ],
             'info' => [
-                'title'       => '#1d4ed8',
+                'title' => '#1d4ed8',
                 'description' => '#3b82f6',
-                'icon'        => '#3b82f6',
+                'icon' => '#3b82f6',
             ],
         ]);
+
         return $this;
     }
 }

src/AlertBoxServiceProvider.php

@@ -13,7 +13,7 @@ public function register(): void
 
     public function boot(): void
     {
-        $this->loadViewsFrom(__DIR__ . '/../resources/views', 'alert-box');  
+        $this->loadViewsFrom(__DIR__.'/../resources/views', 'alert-box');
         // No CSS assets needed - using Tailwind CSS utility classes only
     }
 }