Release v2.5.1

- Update PHP requirement to ^8.3
- Upgrade laravel/framework to ^13.0 and laravel/tinker to ^3.0
- Upgrade pestphp/pest to ^4.0 and pest-plugin-laravel to ^4.0
- Update spatie/laravel-csp to ^3.23 and barryvdh/laravel-debugbar to ^4.1
- Add session serialization config option (defaults to 'json')
- Add FlasherSessionTest to verify flasher works with JSON sessions

.ackrc

@@ -0,0 +1,19 @@
+--ignore-dir=.idea
+--ignore-dir=.cache
+--ignore-dir=vendor
+--ignore-dir=yoeunes
+--ignore-dir=node_modules
+
+--ignore-dir=demo/laravel/vendor
+--ignore-dir=demo/laravel/node_modules
+--ignore-dir=demo/laravel/storage
+--ignore-dir=demo/laravel/bootstrap/cache
+
+--ignore-dir=demo/symfony/vendor
+--ignore-dir=demo/symfony/node_modules
+--ignore-dir=demo/symfony/var
+
+--ignore-dir=docs/.jekyll-cache
+--ignore-dir=docs/_site
+--ignore-dir=docs/node_modules
+--ignore-dir=docs/dist

.all-contributorsrc

@@ -1 +1,109 @@
-undefined
+{
+    "projectName": "php-flasher",
+    "projectOwner": "php-flasher",
+    "repoType": "github",
+    "repoHost": "https://github.com",
+    "files": [
+        "README.md"
+    ],
+    "imageSize": 100,
+    "commit": false,
+    "commitConvention": "angular",
+    "contributorsPerLine": 7,
+    "linkToUsage": false,
+    "contributors": [
+        {
+            "login": "yoeunes",
+            "name": "Younes ENNAJI",
+            "avatar_url": "https://avatars.githubusercontent.com/u/10859693?v=4",
+            "profile": "https://www.linkedin.com/in/younes--ennaji/",
+            "contributions": [
+                "code",
+                "doc",
+                "maintenance"
+            ]
+        },
+        {
+            "login": "salmayno",
+            "name": "Salma Mourad",
+            "avatar_url": "https://avatars.githubusercontent.com/u/27933199?v=4",
+            "profile": "https://github.com/salmayno",
+            "contributions": [
+                "financial"
+            ]
+        },
+        {
+            "login": "codenashwan",
+            "name": "Nashwan Abdullah",
+            "avatar_url": "https://avatars.githubusercontent.com/u/35005761?v=4",
+            "profile": "https://www.youtube.com/rstacode",
+            "contributions": [
+                "financial"
+            ]
+        },
+        {
+            "login": "darviscommerce",
+            "name": "Arvid de Jong",
+            "avatar_url": "https://avatars.githubusercontent.com/u/7394837?v=4",
+            "profile": "https://darvis.nl/",
+            "contributions": [
+                "financial"
+            ]
+        },
+        {
+            "login": "ash-jc-allen",
+            "name": "Ash Allen",
+            "avatar_url": "https://avatars.githubusercontent.com/u/39652331?v=4",
+            "profile": "https://ashallendesign.co.uk/",
+            "contributions": [
+                "design"
+            ]
+        },
+        {
+            "login": "murrant",
+            "name": "Tony Murray",
+            "avatar_url": "https://avatars.githubusercontent.com/u/39462?v=4",
+            "profile": "https://about.me/murrant",
+            "contributions": [
+                "code"
+            ]
+        },
+        {
+            "login": "n3wborn",
+            "name": "Stéphane P",
+            "avatar_url": "https://avatars.githubusercontent.com/u/10246722?v=4",
+            "profile": "https://github.com/n3wborn",
+            "contributions": [
+                "doc"
+            ]
+        },
+        {
+            "login": "LucasStorm",
+            "name": "Lucas Maciel",
+            "avatar_url": "https://avatars.githubusercontent.com/u/80225404?v=4",
+            "profile": "https://www.instagram.com/lucas.maciel_z",
+            "contributions": [
+                "design"
+            ]
+        },
+        {
+            "login": "AhmedGamal",
+            "name": "Ahmed Gamal",
+            "avatar_url": "https://avatars.githubusercontent.com/u/11786167?v=4",
+            "profile": "https://github.com/AhmedGamal",
+            "contributions": [
+                "code",
+                "doc"
+            ]
+        },
+        {
+            "login": "BrookeDot",
+            "name": "Brooke.",
+            "avatar_url": "https://avatars.githubusercontent.com/u/150348?v=4",
+            "profile": "https://github.com/BrookeDot",
+            "contributions": [
+                "doc"
+            ]
+        }
+    ]
+}

.babelrc.json

@@ -0,0 +1,3 @@
+{
+    "presets": [["@babel/env", { "modules": false }]]
+}

.browserslistrc

@@ -0,0 +1,4 @@
+> 1%
+last 2 versions
+not dead
+not IE 11

.czrc

@@ -1,3 +0,0 @@
-{
-  "path": "cz-conventional-changelog"
-}

.editorconfig

@@ -12,4 +12,11 @@ insert_final_newline = true
 trim_trailing_whitespace = true
 
 [*.md]
+max_line_length = 0
 trim_trailing_whitespace = false
+
+[auto_closer.yaml]
+indent_size = 2
+
+[COMMIT_EDITMSG]
+max_line_length = 0

.eslintignore

@@ -0,0 +1,3 @@
+**/node_modules
+src/**/Resources/public/**
+src/**/Resources/dist/**

.gitattributes

@@ -1,13 +1,16 @@
+* text=auto
 
-# Path-based git attributes
-# https://www.kernel.org/pub/software/scm/git/docs/gitattributes.html
+*.css diff=css
+*.md diff=markdown
+*.php diff=php
 
-# Ignore all test and documentation with "export-ignore".
-/.gitattributes     export-ignore
-/.gitignore         export-ignore
-/.travis.yml        export-ignore
-/phpunit.xml.dist   export-ignore
-/.scrutinizer.yml   export-ignore
-/.styleci.yml       export-ignore
-/tests              export-ignore
-/.editorconfig      export-ignore
+/.github export-ignore
+/bin export-ignore
+/tests export-ignore
+/.editorconfig export-ignore
+/.gitattributes export-ignore
+/.gitignore export-ignore
+/CHANGELOG-* export-ignore
+/CODE_OF_CONDUCT.md export-ignore
+/CONTRIBUTING.md export-ignore
+/phpunit.xml.dist export-ignore

.github/FUNDING.yml

@@ -1,5 +1 @@
 github: yoeunes
-patreon: yoeunes
-ko_fi: yoeunes
-open_collective: php-flasher
-custom: https://www.paypal.com/paypalme/yoeunes

.github/workflows/publish.yaml

@@ -0,0 +1,83 @@
+name: 🚀 Publish assets to NPM
+
+on:
+    release:
+        types: [ published ]
+
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        name: Run Tests Before Publishing
+
+        steps:
+            -   name: 📥 Checkout Code
+                uses: actions/checkout@v4
+
+            -   name: 🔧 Setup Node.js
+                uses: actions/setup-node@v4
+                with:
+                    node-version: '20.x'
+                    cache: 'npm'
+
+            -   name: 📦 Install Dependencies
+                run: npm ci
+
+            -   name: ✅ Run Tests
+                run: npm run test
+
+    publish-prime:
+        needs: test
+        runs-on: ubuntu-latest
+        defaults:
+            run:
+                working-directory: ./src/Prime/Resources
+        permissions:
+            contents: read
+            id-token: write
+        steps:
+            -   uses: actions/checkout@v4
+
+            -   uses: actions/setup-node@v4
+                with:
+                    node-version: '20.x'
+                    registry-url: 'https://registry.npmjs.org'
+
+            -   name: Install dependencies
+                run: npm install
+
+            -   name: Publish to NPM
+                run: npm publish --access public
+                env:
+                    NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+    publish-plugin:
+        needs: test
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+            id-token: write
+        strategy:
+            fail-fast: false
+            matrix:
+                path:
+                    - ./src/Noty/Prime/Resources
+                    - ./src/Notyf/Prime/Resources
+                    - ./src/SweetAlert/Prime/Resources
+                    - ./src/Toastr/Prime/Resources
+        steps:
+            -   uses: actions/checkout@v4
+
+            -   uses: actions/setup-node@v4
+                with:
+                    node-version: '20.x'
+                    registry-url: 'https://registry.npmjs.org'
+
+            -   name: Install dependencies
+                run: npm install
+                working-directory: ${{ matrix.path }}
+
+            -   name: Publish to NPM
+                run: npm publish --access public
+                working-directory: ${{ matrix.path }}
+                env:
+                    NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/tests.yaml

@@ -1,147 +1,233 @@
-name: tests
+name: qa
 
 on:
     push:
+        branches:
+            - main
+            - 2.x
+    pull_request:
+    schedule:
+        -   cron: '0 0 * * *' # Daily at midnight
 
 jobs:
-    symfony-test:
-        runs-on: ${{ matrix.os }}
+    javascript-tests:
+        runs-on: ubuntu-latest
+        name: JavaScript Tests
+
+        steps:
+            -   name: 📥 Checkout Code
+                uses: actions/checkout@v4
+
+            -   name: 🔧 Setup Node.js
+                uses: actions/setup-node@v4
+                with:
+                    node-version: '20.x'
+                    cache: 'npm'
+
+            -   name: 📦 Install Dependencies
+                run: npm ci
+
+            -   name: ✅ Run Tests
+                run: npm run test
+
+            -   name: 📊 Run Coverage
+                run: npm run test:coverage
+
+    static-analysis:
+        runs-on: ubuntu-latest
         strategy:
             fail-fast: false
             matrix:
-                os: [ubuntu-latest]
-                symfony: [ 7.1.*, 7.0.*, 6.4.*, 6.3.*, 6.2.*, 6.1.*, 6.0.*, 5.4.*, 5.3.*, 5.2.*, 5.1.*, 5.0.*, 4.4.*, 4.3.*, 4.2.*, 4.1.*, 4.0.*, 3.4.*, 3.3.*, 3.2.*, 3.1.*, 3.0.*, 2.8.*, 2.7.*, 2.6.*, 2.5.*, 2.4.*, 2.3.*, 2.2.*, 2.1.*, 2.0.* ]
-                include:
-                    - { symfony: 7.1.*, php: 8.3, phpunit: 10.5.* }
-                    - { symfony: 7.0.*, php: 8.2, phpunit: 10.5.* }
-                    - { symfony: 6.4.*, php: 8.2, phpunit: 9.5.*  }
-                    - { symfony: 6.3.*, php: 8.2, phpunit: 9.5.*  }
-                    - { symfony: 6.2.*, php: 8.1, phpunit: 9.5.*  }
-                    - { symfony: 6.1.*, php: 8.1, phpunit: 9.5.*  }
-                    - { symfony: 6.0.*, php: 8.0, phpunit: 9.5.*  }
-                    - { symfony: 5.4.*, php: 7.2, phpunit: 8.3.*  }
-                    - { symfony: 5.3.*, php: 7.2, phpunit: 8.3.*  }
-                    - { symfony: 5.2.*, php: 7.2, phpunit: 8.3.*  }
-                    - { symfony: 5.1.*, php: 7.2, phpunit: 8.3.*  }
-                    - { symfony: 5.0.*, php: 7.2, phpunit: 8.3.*  }
-                    - { symfony: 4.4.*, php: 7.1, phpunit: 7.0.*  }
-                    - { symfony: 4.3.*, php: 7.1, phpunit: 7.0.*  }
-                    - { symfony: 4.2.*, php: 7.1, phpunit: 7.0.*  }
-                    - { symfony: 4.1.*, php: 7.1, phpunit: 7.0.*  }
-                    - { symfony: 4.0.*, php: 7.1, phpunit: 7.0.*  }
-                    - { symfony: 3.4.*, php: 5.5, phpunit: 4.8.36 }
-                    - { symfony: 3.3.*, php: 5.5, phpunit: 4.8.36 }
-                    - { symfony: 3.2.*, php: 5.5, phpunit: 4.8.36 }
-                    - { symfony: 3.1.*, php: 5.5, phpunit: 4.8.36 }
-                    - { symfony: 3.0.*, php: 5.5, phpunit: 4.8.36 }
-                    - { symfony: 2.8.*, php: 5.3, phpunit: 4.8.36 }
-                    - { symfony: 2.7.*, php: 5.3, phpunit: 4.8.36 }
-                    - { symfony: 2.6.*, php: 5.3, phpunit: 4.8.36 }
-                    - { symfony: 2.5.*, php: 5.3, phpunit: 4.8.36 }
-                    - { symfony: 2.4.*, php: 5.3, phpunit: 4.8.36 }
-                    - { symfony: 2.3.*, php: 5.3, phpunit: 4.8.36 }
-                    - { symfony: 2.2.*, php: 5.3, phpunit: 4.8.36 }
-                    - { symfony: 2.1.*, php: 5.3, phpunit: 4.8.36 }
-                    - { symfony: 2.0.*, php: 5.3, phpunit: 4.8.36 }
+                php: [ 8.2 ]
 
-        name: symfony[${{ matrix.symfony }}] php[${{ matrix.php }}] - ${{ matrix.os }}
+        name: php v${{ matrix.php }}
 
         steps:
-            -   name: Checkout code
+            -   name: 📥 Checkout Code
                 uses: actions/checkout@v4
 
-            -   name: Setup PHP
+            -   name: 🔧 Setup PHP
                 uses: shivammathur/setup-php@v2
                 with:
                     php-version: ${{ matrix.php }}
                     coverage: none
 
-            -   name: Cache dependencies
-                uses: actions/cache@v3
+            -   name: 🚚 Cache Composer Dependencies
+                uses: actions/cache@v4
                 with:
                     path: ~/.composer/cache
-                    key: ${{ runner.os }}-composer-${{ hashFiles('composer.json') }}
-                    restore-keys: ${{ runner.os }}-composer
+                    key: ${{ runner.os }}-composer-${{ matrix.php }}-${{ hashFiles('composer.json') }}
+                    restore-keys: ${{ runner.os }}-composer-${{ matrix.php }}-
 
-            -   name: Install dependencies
+            -   name: 📦 Install Dependencies
                 run: |
-                    sed -i '/\"require\": {/,/},/d; /\"require-dev\": {/,/},/d' composer.json
                     composer config --global allow-plugins true
-                    composer config extra.symfony.require "${{ matrix.symfony }}"
+                    composer install --no-interaction --prefer-dist --optimize-autoloader
 
-                    if [[ "${{ matrix.symfony }}" == "7.0.*" || "${{ matrix.symfony }}" == "7.1.*" ]]; then
-                        composer require "symfony/config:${{ matrix.symfony }}" \
-                                         "symfony/console:${{ matrix.symfony }}" \
-                                         "symfony/dependency-injection:${{ matrix.symfony }}" \
-                                         "symfony/http-kernel:${{ matrix.symfony }}" \
-                                         "symfony/translation:${{ matrix.symfony }}" \
-                                         "symfony/framework-bundle:${{ matrix.symfony }}" \
-                                         "symfony/twig-bundle:${{ matrix.symfony }}" \
-                                         "phpunit/phpunit:${{ matrix.phpunit }}" \
-                                         "monolog/monolog" --no-interaction --no-update
-                    else
-                        composer require "symfony/symfony:${{ matrix.symfony }}" "phpunit/phpunit:${{ matrix.phpunit }}" "monolog/monolog" --no-interaction --no-update
-                    fi
+            -   name: 🧹 Run PHP CS Fixer (Code Style)
+                run: vendor/bin/php-cs-fixer fix --dry-run --diff
 
-                    composer update --prefer-stable --prefer-dist
+            -   name: 🔍 Run PHPStan (Static Analysis)
+                run: vendor/bin/phpstan analyse --no-progress
 
-            -   name: Execute tests
-                run: vendor/bin/phpunit --configuration=phpunit-symfony.xml
+            -   name: 🚀 Run PHPLint (Syntax Check)
+                run: vendor/bin/phplint
 
-    laravel-test:
-        runs-on: ${{ matrix.os }}
+    prime-test:
+        needs: static-analysis
+        runs-on: ubuntu-latest
         strategy:
             fail-fast: false
             matrix:
-                os: [ubuntu-latest]
-                laravel: [ 11.*, 10.*, 9.*, 8.*, 7.*, 6.*, 5.8.*, 5.7.*, 5.6.*, 5.5.*, 5.4.*, 5.3.*, 5.2.*, 5.1.*, 5.0.*, 4.2.*, 4.1.*, 4.0.* ]
                 include:
-                    - { laravel: 11.*,  testbench: 9.*,   php: 8.3, phpunit: 10.5.* }
-                    - { laravel: 11.*,  testbench: 9.*,   php: 8.2, phpunit: 10.5.* }
-                    - { laravel: 10.*,  testbench: 8.*,   php: 8.2, phpunit: 10.2.* }
-                    - { laravel: 9.*,   testbench: 7.*,   php: 8.1, phpunit: 9.5.*  }
-                    - { laravel: 8.*,   testbench: 6.*,   php: 7.3, phpunit: 9.3.*  }
-                    - { laravel: 7.*,   testbench: 5.*,   php: 7.3, phpunit: 8.4.*  }
-                    - { laravel: 6.*,   testbench: 4.*,   php: 7.2, phpunit: 8.3.*  }
-                    - { laravel: 5.8.*, testbench: 3.8.*, php: 7.1, phpunit: 7.5.*  }
-                    - { laravel: 5.7.*, testbench: 3.7.*, php: 7.1, phpunit: 7.0.*  }
-                    - { laravel: 5.6.*, testbench: 3.6.*, php: 7.1, phpunit: 7.0.*  }
-                    - { laravel: 5.5.*, testbench: 3.5.*, php: 7.0, phpunit: 6.0.*  }
-                    - { laravel: 5.4.*, testbench: 3.4.*, php: 5.6, phpunit: 5.7.*  }
-                    - { laravel: 5.3.*, testbench: 3.3.*, php: 5.6, phpunit: 4.8.*  }
-                    - { laravel: 5.2.*, testbench: 3.2.*, php: 5.5, phpunit: 4.8.*  }
-                    - { laravel: 5.1.*, testbench: 3.1.*, php: 5.5, phpunit: 4.8.*  }
-                    - { laravel: 5.0.*, testbench: 3.0.*, php: 5.4, phpunit: 4.8.*  }
-                    - { laravel: 4.2.*, testbench: 2.2.*, php: 5.4, phpunit: 4.8.*  }
-                    - { laravel: 4.1.*, testbench: 2.1.*, php: 5.4, phpunit: 4.8.*  }
-                    - { laravel: 4.0.*, testbench: 2.0.*, php: 5.4, phpunit: 4.8.*  }
+                    - { php: 8.4, phpunit: 10.5.* }
+                    - { php: 8.3, phpunit: 10.5.* }
+                    - { php: 8.2, phpunit: 10.5.* }
 
-        name: laravel[${{ matrix.laravel }}] php[${{ matrix.php }}] - ${{ matrix.os }}
+        name: php v${{ matrix.php }}
 
         steps:
-            -   name: Checkout code
+            -   name: 📥 Checkout code
                 uses: actions/checkout@v4
 
-            -   name: Setup PHP
+            -   name: 🔧 Setup PHP
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    coverage: none
+
+            -   name: 🚚 Cache dependencies
+                uses: actions/cache@v4
+                with:
+                    path: ~/.composer/cache
+                    key: ${{ runner.os }}-composer-${{ matrix.php }}-${{ hashFiles('composer.json') }}
+                    restore-keys: ${{ runner.os }}-composer-${{ matrix.php }}-
+
+            -   name: 📦 Install dependencies
+                run: |
+                    sed -i '/"require": {/,/},/d; /"require-dev": {/,/},/d' composer.json
+                    composer config --global allow-plugins true
+                    composer require "phpunit/phpunit:${{ matrix.phpunit }}" "mockery/mockery" "psr/container" --no-interaction --no-update
+                    composer update --prefer-lowest -W --no-interaction --prefer-dist --optimize-autoloader
+
+            -   name: ✅ Execute tests
+                run: vendor/bin/phpunit --testsuite prime
+
+    symfony-test:
+        runs-on: ubuntu-latest
+        strategy:
+            fail-fast: false
+            matrix:
+                include:
+                    - { symfony: 8.0.x-dev, php: 8.4, phpunit: 10.5.* }
+                    - { symfony: 7.4.x-dev, php: 8.2, phpunit: 10.5.* }
+                    - { symfony: 7.3.*, php: 8.5, phpunit: 10.5.* }
+                    - { symfony: 7.3.*, php: 8.4, phpunit: 10.5.* }
+                    - { symfony: 7.3.*, php: 8.3, phpunit: 10.5.* }
+                    - { symfony: 7.3.*, php: 8.2, phpunit: 10.5.* }
+                    - { symfony: 7.2.*, php: 8.2, phpunit: 10.5.* }
+                    - { symfony: 7.1.*, php: 8.2, phpunit: 10.5.* }
+                    - { symfony: 7.0.*, php: 8.2, phpunit: 10.5.* }
+
+        name: symfony v${{ matrix.symfony }} x php v${{ matrix.php }}
+
+        steps:
+            -   name: 📥 Checkout code
+                uses: actions/checkout@v4
+
+            -   name: 🔧 Setup PHP
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    coverage: none
+
+            -   name: 🚚 Cache dependencies
+                uses: actions/cache@v4
+                with:
+                    path: ~/.composer/cache
+                    key: ${{ runner.os }}-composer-${{ matrix.php }}-${{ hashFiles('composer.json') }}
+                    restore-keys: ${{ runner.os }}-composer-${{ matrix.php }}-
+
+            -   name: 📦 Install dependencies
+                run: |
+                    sed -i '/"require": {/,/},/d; /"require-dev": {/,/},/d' composer.json
+                    composer config --global allow-plugins true
+                    composer config extra.symfony.require "${{ matrix.symfony }}"
+
+                    if [[ "${{ matrix.symfony }}" == *"-dev"* ]]; then
+                        echo "Setting minimum-stability to dev for ${{ matrix.symfony }}"
+                        composer config minimum-stability "dev"
+                        composer config prefer-stable true
+                    fi
+
+                    composer require "symfony/config:${{ matrix.symfony }}" "symfony/console:${{ matrix.symfony }}" "symfony/dependency-injection:${{ matrix.symfony }}" "symfony/framework-bundle:${{ matrix.symfony }}" "symfony/http-kernel:${{ matrix.symfony }}" "symfony/translation:${{ matrix.symfony }}" "symfony/twig-bundle:${{ matrix.symfony }}" "phpunit/phpunit:${{ matrix.phpunit }}" "mockery/mockery" "psr/container" "monolog/monolog" --no-interaction --no-update
+
+                    if [[ "${{ matrix.symfony }}" == *"-dev"* ]]; then
+                        echo "Running composer update (latest dependencies)"
+                        composer update -W --no-interaction --prefer-dist --optimize-autoloader
+                    else
+                        echo "Running composer update --prefer-lowest"
+                        composer update --prefer-lowest -W --no-interaction --prefer-dist --optimize-autoloader
+                    fi
+
+            -   name: ✅ Execute tests
+                run: vendor/bin/phpunit --testsuite symfony
+
+    laravel-test:
+        runs-on: ubuntu-latest
+        strategy:
+            fail-fast: false
+            matrix:
+                include:
+                    - { laravel: 13.x-dev, testbench: 11.x-dev, php: 8.5, phpunit: 11.5.* }
+                    - { laravel: 13.x-dev, testbench: 11.x-dev, php: 8.4, phpunit: 11.5.* }
+                    - { laravel: 13.x-dev, testbench: 11.x-dev, php: 8.3, phpunit: 11.5.* }
+                    - { laravel: 12.*,  testbench: 10.*, php: 8.5, phpunit: 11.5.* }
+                    - { laravel: 12.*,  testbench: 10.*, php: 8.4, phpunit: 11.5.* }
+                    - { laravel: 12.*,  testbench: 10.*, php: 8.3, phpunit: 11.5.* }
+                    - { laravel: 12.*,  testbench: 10.*, php: 8.2, phpunit: 11.5.* }
+                    - { laravel: 11.*,  testbench: 9.*, php: 8.2, phpunit: 10.5.* }
+
+        name: laravel v${{ matrix.laravel }} x php v${{ matrix.php }}
+
+        steps:
+            -   name: 📥 Checkout code
+                uses: actions/checkout@v4
+
+            -   name: 🔧 Setup PHP
                 uses: shivammathur/setup-php@v2
                 with:
                     php-version: ${{ matrix.php }}
                     extensions: fileinfo
                     coverage: none
 
-            -   name: Cache dependencies
-                uses: actions/cache@v3
+            -   name: 🚚 Cache dependencies
+                uses: actions/cache@v4
                 with:
                     path: ~/.composer/cache
-                    key: ${{ runner.os }}-composer-${{ hashFiles('composer.json') }}
-                    restore-keys: ${{ runner.os }}-composer
+                    key: ${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
+                    restore-keys: ${{ matrix.php }}-composer
 
-            -   name: Install dependencies
+            -   name: 📦 Install dependencies
                 run: |
                     sed -i '/\"require\": {/,/},/d; /\"require-dev\": {/,/},/d' composer.json
                     composer config --global allow-plugins true
-                    composer require "laravel/framework:${{ matrix.laravel }}" "phpunit/phpunit:${{ matrix.phpunit }}" "orchestra/testbench:${{ matrix.testbench }}" --no-interaction --no-update
-                    composer update --prefer-stable --prefer-dist
 
-            -   name: Execute tests
-                run: vendor/bin/phpunit --configuration=phpunit-laravel.xml
+                    if [[ "${{ matrix.laravel }}" == *"-dev"* ]]; then
+                        echo "Setting minimum-stability to dev for ${{ matrix.laravel }}"
+                        composer config minimum-stability "dev"
+                        composer config prefer-stable true
+                    fi
+
+                    composer require "laravel/framework:${{ matrix.laravel }}" "phpunit/phpunit:${{ matrix.phpunit }}" "orchestra/testbench:${{ matrix.testbench }}" --no-interaction --no-update
+
+                    if [[ "${{ matrix.laravel }}" == *"-dev"* ]]; then
+                        echo "Running composer update (latest dependencies)"
+                        composer update -W --no-interaction --prefer-dist --optimize-autoloader
+                    else
+                        echo "Running composer update --prefer-lowest"
+                        composer update --prefer-lowest -W --no-interaction --prefer-dist --optimize-autoloader
+                    fi
+
+            -   name: ✅ Execute tests
+                run: vendor/bin/phpunit --testsuite laravel

.gitignore

@@ -1,14 +1,27 @@
-.idea
-vendor
-composer.lock
-.phpunit.result.cache
-.phpcs-cache
-.php-cs-fixer.cache
+/.idea/
+/.DS_Store
 
-packs/**/composer.lock
-packs/**/vendor/
+/vendor/
+/node_modules/
 
-node_modules/
-coverage/
-.phpunit.cache/
-.run/
+/coverage/
+
+/.cache/php-cs-fixer/
+/.cache/phplint/
+/.cache/phpstan/
+/.cache/phpunit/
+
+/.php-cs-fixer.php
+/phpunit.xml
+/taskfile.yml
+/phpstan.neon
+
+/demo/laravel/node_modules/
+/demo/symfony/node_modules/
+
+/npm-debug.log
+
+/tests/Symfony/Fixtures/project/public/vendor/
+
+src/**/vendor/
+src/**/composer.lock

.ncurc

@@ -0,0 +1,7 @@
+{
+    "upgrade": true,
+    "target": "semver",
+    "format": "group",
+    "color": true,
+    "root": true
+}

.nvmrc

@@ -0,0 +1 @@
+23.0.0

.php-cs-fixer.dist.php

@@ -1,29 +1,40 @@
 <?php
 
-/*
- * This file is part of the PHPFlasher package.
- * (c) Younes KHOUBZA <younes.khoubza@gmail.com>
- */
+declare(strict_types=1);
 
-$header = <<<'EOF'
-This file is part of the PHPFlasher package.
-(c) Younes KHOUBZA <younes.khoubza@gmail.com>
-EOF;
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
+use PhpCsFixer\Runner\Parallel\ParallelConfigFactory;
 
-$rules = array(
-    '@Symfony' => true,
-    'header_comment' => array('header' => $header),
-    'array_syntax' => array('syntax' => 'long'),
-    'visibility_required' => array('elements' => array('property', 'method')),
-    'ordered_class_elements' => true,
-);
+$finder = Finder::create()
+    ->in([
+        __DIR__.'/src',
+        __DIR__.'/tests',
+        __DIR__.'/phpstorm',
+    ])
+    ->append([__FILE__])
+;
 
-$finder = new PhpCsFixer\Finder();
-$finder->in(__DIR__)->exclude(__DIR__.'/vendor');
-
-$config = new PhpCsFixer\Config();
-
-return $config->setFinder($finder)
-    ->setUsingCache(false)
+return (new Config())
+    ->setParallelConfig(ParallelConfigFactory::detect())
     ->setRiskyAllowed(true)
-    ->setRules($rules);
+    ->setRules([
+        '@PSR12' => true,
+        'declare_strict_types' => true,
+        '@PHP71Migration' => true,
+        '@PHPUnit75Migration:risky' => true,
+        '@Symfony' => true,
+        '@Symfony:risky' => true,
+        'protected_to_private' => false,
+        'native_constant_invocation' => ['strict' => false],
+        'no_superfluous_phpdoc_tags' => [
+            'remove_inheritdoc' => true,
+            'allow_unused_params' => true, // for future-ready params, to be replaced with https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/issues/7377
+        ],
+        'modernize_strpos' => true,
+        'get_class_to_class_keyword' => true,
+        'nullable_type_declaration' => true,
+        'trailing_comma_in_multiline' => ['elements' => ['arrays', 'match', 'parameters']],
+    ])
+    ->setFinder($finder)
+    ->setCacheFile('.cache/php-cs-fixer/cache.json');

.php-version

@@ -0,0 +1 @@
+8.2

.phplint.yml

@@ -0,0 +1,12 @@
+exclude:
+    - vendor/
+    - demo/
+    - docs/
+    - node_modules/
+
+jobs: 10
+
+extensions:
+    - php
+
+cache: .cache/phplint/

.prettierignore

@@ -0,0 +1,3 @@
+**/node_modules
+src/**/Resources/public/**
+src/**/Resources/dist/**

.prettierrc

@@ -0,0 +1,46 @@
+{
+    "semi": true,
+    "trailingComma": "all",
+    "singleQuote": true,
+    "printWidth": 100,
+    "tabWidth": 4,
+    "arrowParens": "avoid",
+    "jsxBracketSameLine": true,
+    "overrides": [
+        {
+            "files": "*.scss",
+            "options": {
+                "parser": "scss",
+                "singleQuote": false,
+                "tabWidth": 4
+            }
+        },
+        {
+            "files": "*.json",
+            "options": {
+                "parser": "json",
+                "singleQuote": false,
+                "tabWidth": 4
+            }
+        },
+        {
+            "files": "*.{ts,tsx}",
+            "options": {
+                "parser": "typescript"
+            }
+        },
+        {
+            "files": "*.{js,jsx}",
+            "options": {
+                "parser": "babel"
+            }
+        },
+        {
+            "files": "*.yaml",
+            "options": {
+                "parser": "yaml",
+                "tabWidth": 4
+            }
+        }
+    ]
+}

.shared/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: yoeunes

.shared/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,8 @@
+Please do not submit any Pull Requests here. They will be closed.
+---
+
+Please submit your PR here instead:
+https://github.com/php-flasher/php-flasher
+
+This repository is what we call a "subtree split": a read-only subset of that main repository.
+We're looking forward to your PR there!

.shared/.github/workflows/auto_closer.yaml

@@ -1,22 +0,0 @@
-name: Auto Closer PR
-
-on:
-  pull_request_target:
-    types: [opened]
-
-jobs:
-  run:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: superbrothers/close-pull-request@v3
-      with:
-        comment: |
-          Hi, thank you for your contribution.
-
-          Unfortunately, this repository is read-only. It's a split from our main monorepo repository.
-
-          We'd like to kindly ask you to move the contribution there - https://github.com/php-flasher/php-flasher.
-
-          We'll check it, review it and give you feed back right way.
-
-          Thank you.

.shared/.github/workflows/close-pull-request.yml

@@ -0,0 +1,20 @@
+name: Close Pull Request
+
+on:
+    pull_request_target:
+        types: [opened]
+
+jobs:
+    run:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: superbrothers/close-pull-request@v3
+              with:
+                  comment: |
+                      Thanks for your Pull Request! We love contributions.
+
+                      However, you should instead open your PR on the main repository:
+                      https://github.com/php-flasher/php-flasher
+
+                      This repository is what we call a "subtree split": a read-only subset of that main repository.
+                      We're looking forward to your PR there!

.stylelintrc

@@ -0,0 +1,3 @@
+{
+  "extends": ["stylelint-config-standard-scss", "stylelint-config-recess-order"]
+}

CHANGELOG.md

@@ -0,0 +1,99 @@
+# CHANGELOG for 2.x
+
+## [Unreleased](https://github.com/php-flasher/php-flasher/compare/v2.5.1...2.x)
+
+## [v2.5.1](https://github.com/php-flasher/php-flasher/compare/v2.5.0...v2.5.1) - 2026-03-28
+
+### Fixed
+
+* fix [Laravel] Fix Laravel 13 JSON session serialization compatibility - StorageManager now handles both array and object formats returned by session
+
+## [v2.5.0](https://github.com/php-flasher/php-flasher/compare/v2.1.4...v2.5.0) - 2026-03-07
+
+### Added
+
+* feature [Laravel] Improve Laravel Octane support by resetting FallbackSession static storage between requests to prevent notification leakage
+* feature [Symfony] Add FrankenPHP/Swoole/RoadRunner support with WorkerListener that implements ResetInterface and is tagged with kernel.reset
+* feature [Symfony] Add reset() method to FallbackSession for long-running process support
+* feature [Flasher] Add Hotwire/Turbo Drive support with turbo:before-cache event listener to clean up notifications before page caching
+* feature [Flasher] Add event dispatching system for all notification adapters and themes with Livewire integration:
+  - [Toastr] Dispatch events: `flasher:toastr:click`, `flasher:toastr:close`, `flasher:toastr:show`, `flasher:toastr:hidden`
+  - [Noty] Dispatch events: `flasher:noty:click`, `flasher:noty:close`, `flasher:noty:show`, `flasher:noty:hover`
+  - [Notyf] Dispatch events: `flasher:notyf:click`, `flasher:notyf:dismiss`
+  - [Themes] Dispatch events: `flasher:theme:click` (generic) and `flasher:theme:{name}:click` (specific)
+  - [Laravel] Add LivewireListener classes for all adapters and themes to enable Livewire event handling
+* feature [Flasher] Add 16 notification themes: Amazon, Amber, Jade, Crystal, and more
+* feature [DX] Add `@method` annotations to FlasherInterface and NotificationFactoryInterface for better IDE autocompletion
+* feature [DX] Add Type::all() and Type::isValid() helper methods with PHPStan type narrowing
+* feature [DX] Add `@throws` annotations to FlasherContainer methods for better exception documentation
+* feature [DX] Add FlasherContainer::setContainer() method as convenient alias for testing
+* feature [DX] Add PHPStan type alias `NotificationType` for valid notification types
+
+### Fixed
+
+* fix [SweetAlert] Fix SweetAlertBuilder::question() bug where options parameter was being ignored
+* fix [Flasher] Fix potential runtime error in Envelope::toArray() when no PresentableStampInterface stamps exist
+* fix [Flasher] Use more specific \Random\RandomException in IdStamp instead of broad \Exception
+* fix [Flasher] Update Livewire navigation cleanup to use correct .fl-wrapper selector instead of unused .fl-no-cache class
+* fix [Flasher] Fix FilterCriteria uninitialized property error when constructed with empty array
+* fix [Flasher] Fix null comparison issues in PriorityCriteria, HopsCriteria, and DelayCriteria that relied on PHP's implicit null-to-0 coercion
+* fix [Flasher] Add type validation for callable factory return values in NotificationFactoryLocator with descriptive error messages
+* fix [Flasher] Add error handling for invalid regex patterns in ResponseExtension::isPathExcluded()
+* fix [Flasher] Fix ContentSecurityPolicyHandler parsing of CSP headers with trailing semicolons creating empty directive keys
+* fix [Flasher] Add reset() method to ContentSecurityPolicyHandler to fix CSP state leak in long-running processes (Octane, FrankenPHP)
+* fix [Flasher] Fix FilterEvent::setFilter() type inconsistency - now accepts FilterInterface instead of concrete Filter class
+* fix [Flasher] Remove redundant callable check in FlasherContainer::getContainer()
+* fix [Flasher] Fix NotificationStorageMethods::resolveResourceName() return type from ?string to string (never returns null)
+* fix [Flasher] Fix parameter name inconsistency in NotificationBuilderInterface::options() - changed $merge to $append to match implementation
+* fix [Flasher] Add type validation for callable presenter return values in ResponseManager with descriptive error messages
+* fix [Flasher] Fix FlasherPlugin::normalizePlugins() losing scripts/styles when both top-level and plugin-level configs are provided - replaced array union operator with array_merge
+* fix [Flasher] Simplify FlasherPlugin::normalizeFlashBag() by replacing redundant array union with direct array_merge
+* fix [Flasher] Fix array_merge() syntax in InstallCommand by removing unnecessary empty array
+* fix [Flasher] Add return type validation in FilterCriteria::apply() with proper exception handling
+
+### Changed
+
+* refactor [Flasher] Reduce theme configuration duplication by generating themes programmatically
+* refactor [Flasher] Standardize exception message format in PresetNotFoundException to use brackets like other exceptions
+* refactor [Flasher] Standardize exception message wording in CriteriaNotRegisteredException to use "not found" instead of "is not found"
+* refactor [SweetAlert] Replace @phpstan-ignore-line suppressions with proper @var annotations
+
+## [v2.1.3](https://github.com/php-flasher/php-flasher/compare/v2.1.2...v2.1.3) - 2025-01-25
+
+* bug [#208](https://github.com/php-flasher/php-flasher/issues/208) [Flasher] Add GitHub workflow for automatic publishing of assets to NPM. See [PR #211](https://github.com/php-flasher/php-flasher/pull/211) by [ToshY](https://github.com/ToshY)
+
+## [v2.1.2](https://github.com/php-flasher/php-flasher/compare/v2.1.1...v2.1.2) - 2025-01-18
+
+* bug [#208](https://github.com/php-flasher/php-flasher/issues/208) [Flasher] Allow `main_script` to be nullable. See [PR #209](https://github.com/php-flasher/php-flasher/pull/209) by [yoeunes](https://github.com/yoeunes)
+
+## [v2.1.1](https://github.com/php-flasher/php-flasher/compare/v2.1.0...v2.1.1) - 2024-10-20
+
+* feature [Laravel] Add `excluded_paths` option. See [PR #203](https://github.com/php-flasher/php-flasher/pull/203) by [yoeunes](https://github.com/yoeunes)
+
+## [v2.1.0](https://github.com/php-flasher/php-flasher/compare/v2.0.4...v2.1.0) - 2024-10-19
+
+* feature [Flasher] Update laravel and symfony configuration documentation . See [PR #201](https://github.com/php-flasher/php-flasher/pull/201) by [yoeunes](https://github.com/yoeunes)
+* feature [Flasher] Improve Type Safety and IDE Support with Enhanced PHPDoc Annotations and Stricter PHPStan Validations. See [PR #200](https://github.com/php-flasher/php-flasher/pull/200) by [yoeunes](https://github.com/yoeunes)
+* feature [Symfony] Improve configuration descriptions and add examples. See [PR #199](https://github.com/php-flasher/php-flasher/pull/199) by [yoeunes](https://github.com/yoeunes)
+* feature [Symfony] Add Symfony Profiler integration for PHPFlasher. See [PR #198](https://github.com/php-flasher/php-flasher/pull/198) by [yoeunes](https://github.com/yoeunes)
+
+## [v2.0.4](https://github.com/php-flasher/php-flasher/compare/v2.0.3...v2.0.4) - 2024-09-22
+
+* bug [laravel] Changed HttpKernel import from `Illuminate\Foundation\Http\Kernel` to `Illuminate\Contracts\Http\Kernel` to use the contract interface instead of the concrete implementation. See [PR #197](https://github.com/php-flasher/php-flasher/pull/197) by [yoeunes](https://github.com/yoeunes)
+
+## [v2.0.3](https://github.com/php-flasher/php-flasher/compare/v2.0.2...v2.0.3) - 2024-09-21
+
+* remove border from flasher container by [yoeunes](https://github.com/yoeunes) 
+
+## [v2.0.2](https://github.com/php-flasher/php-flasher/compare/v2.0.1...v2.0.2) - 2024-09-19
+
+* feature [Flasher] add escapeHtml option for secure HTML escaping in notifications. See [PR #196](https://github.com/php-flasher/php-flasher/pull/196) by [yoeunes](https://github.com/yoeunes)
+* feature [Flasher] add Default configuration options. See [PR #183](https://github.com/php-flasher/php-flasher/pull/183) by [AhmedGamal](https://github.com/AhmedGamal)
+* feature [Laravel] Refactor middleware to use Symfony's base response class, addressing compatibility issues. See [PR #184](https://github.com/php-flasher/php-flasher/pull/184) by [yoeunes](https://github.com/yoeunes)
+
+## [v2.0.1](https://github.com/php-flasher/php-flasher/compare/v2.0.0...v2.0.1) - 2024-05-23
+
+* bug [#176](https://github.com/php-flasher/php-flasher/issues/176) [Laravel] Correctly disable FlasherMiddleware when `inject_assets` is set to false. See [PR #177](https://github.com/php-flasher/php-flasher/pull/177) by [yoeunes](https://github.com/yoeunes)
+* bug [#176](https://github.com/php-flasher/php-flasher/issues/176) [Flasher] Ensure global `timeout` option applies to all requests. See [PR #180](https://github.com/php-flasher/php-flasher/pull/180) by [yoeunes](https://github.com/yoeunes)
+* bug [#176](https://github.com/php-flasher/php-flasher/issues/176) [Laravel] Allow disabling of default flash replacement by setting `flash_bag` to false. See [PR #181](https://github.com/php-flasher/php-flasher/pull/181) by [yoeunes](https://github.com/yoeunes)
+* bug [#176](https://github.com/php-flasher/php-flasher/issues/176) [Flasher] Ensure `flash_bag` option overrides default values instead of appending. See [PR #182](https://github.com/php-flasher/php-flasher/pull/182) by [yoeunes](https://github.com/yoeunes)

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 PHPFlasher
+Copyright (c) 2024 PHPFlasher
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,74 +1,333 @@
+<div align="center">
+    <a href="https://github.com/php-flasher/php-flasher/blob/2.x/docs/palestine.md">
+        <img src="https://raw.githubusercontent.com/php-flasher/art/main/palestine-banner-support.svg" width="800px"  alt="Help Palestine"/>
+    </a>
+</div>
+
 <p align="center">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/php-flasher/art/main/php-flasher-github-dark.png">
-      <img src="https://raw.githubusercontent.com/php-flasher/art/main/php-flasher-github.png" alt="PHPFlasher Logo">
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/php-flasher/art/main/php-flasher-logo-dark.png">
+      <img src="https://raw.githubusercontent.com/php-flasher/art/main/php-flasher-logo.png" alt="PHPFlasher Logo">
     </picture>
 </p>
 
-## About PHPFlasher
+<h1 align="center">Elegant Flash Notifications for PHP</h1>
 
-PHPFlasher is a powerful and easy-to-use package that allows you to quickly and easily add flash messages to your Laravel or Symfony projects. 
-Whether you need to alert users of a successful form submission, an error, or any other important information, flash messages are a simple and effective solution for providing feedback to your users. 
+<p align="center">
+    <strong>One line of PHP. Beautiful notifications. Zero JavaScript.</strong>
+</p>
 
-With PHPFlasher, you can easily record and store messages within the session, making it simple to retrieve and display them on the current or next page. 
-This improves user engagement and enhances the overall user experience on your website or application. 
+<p align="center">
+    <a href="https://packagist.org/packages/php-flasher/flasher"><img src="https://img.shields.io/packagist/dt/php-flasher/flasher.svg?style=flat-square&label=downloads" alt="Downloads"></a>
+    <a href="https://github.com/php-flasher/php-flasher"><img src="https://img.shields.io/github/stars/php-flasher/php-flasher.svg?style=flat-square&label=stars" alt="Stars"></a>
+    <a href="https://github.com/php-flasher/php-flasher/releases"><img src="https://img.shields.io/github/v/release/php-flasher/flasher.svg?style=flat-square" alt="Release"></a>
+    <a href="https://packagist.org/packages/php-flasher/flasher"><img src="https://img.shields.io/packagist/php-v/php-flasher/flasher.svg?style=flat-square" alt="PHP Version"></a>
+    <a href="https://github.com/php-flasher/flasher/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square" alt="License"></a>
+</p>
 
-Whether you're a beginner or an experienced developer, PHPFlasher's intuitive and straightforward design makes it easy to integrate into your projects. 
-So, if you're looking for a reliable, flexible and easy to use flash messages solution, PHPFlasher is the perfect choice.
+<p align="center">
+    <a href="https://php-flasher.io"><strong>Documentation</strong></a> ·
+    <a href="https://php-flasher.io/playground"><strong>Live Playground</strong></a> ·
+    <a href="https://github.com/php-flasher/php-flasher/issues"><strong>Report Bug</strong></a>
+</p>
 
+---
 
-## Official Documentation
+## Quick Start
 
-Documentation for PHPFlasher can be found on the [https://php-flasher.io](https://php-flasher.io).
+**Laravel:**
+```bash
+composer require php-flasher/flasher-laravel && php artisan flasher:install
+```
 
-## Contributors and sponsors
+**Symfony:**
+```bash
+composer require php-flasher/flasher-symfony && php bin/console flasher:install
+```
 
-Join our team of contributors and make a lasting impact on our project!
+**That's it!** Now use it:
 
-We are always looking for passionate individuals who want to contribute their skills and ideas.
-Whether you're a developer, designer, or simply have a great idea, we welcome your participation and collaboration.
+```php
+flash()->success('Welcome aboard! Your account is ready.');
+```
 
-Shining stars of our community:
+---
 
-<!-- ALL-CONTRIBUTORS-LIST:START -->
-<!-- prettier-ignore-start -->
-<!-- markdownlint-disable -->
-<table>
-  <tbody>
-    <tr>
-      <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/younes-khoubza/"><img src="https://avatars.githubusercontent.com/u/10859693?v=4?s=100" width="100px;" alt="Younes KHOUBZA"/><br /><sub><b>Younes KHOUBZA</b></sub></a><br /><a href="https://github.com/php-flasher/php-flasher/commits?author=yoeunes" title="Code">💻</a> <a href="https://github.com/php-flasher/php-flasher/commits?author=yoeunes" title="Documentation">📖</a> <a href="#maintenance-yoeunes" title="Maintenance">🚧</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/salmayno"><img src="https://avatars.githubusercontent.com/u/27933199?v=4?s=100" width="100px;" alt="Salma Mourad"/><br /><sub><b>Salma Mourad</b></sub></a><br /><a href="#financial-salmayno" title="Financial">💵</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://www.youtube.com/rstacode"><img src="https://avatars.githubusercontent.com/u/35005761?v=4?s=100" width="100px;" alt="Nashwan Abdullah"/><br /><sub><b>Nashwan Abdullah</b></sub></a><br /><a href="#financial-codenashwan" title="Financial">💵</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://darvis.nl/"><img src="https://avatars.githubusercontent.com/u/7394837?v=4?s=100" width="100px;" alt="Arvid de Jong"/><br /><sub><b>Arvid de Jong</b></sub></a><br /><a href="#financial-darviscommerce" title="Financial">💵</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://ashallendesign.co.uk/"><img src="https://avatars.githubusercontent.com/u/39652331?v=4?s=100" width="100px;" alt="Ash Allen"/><br /><sub><b>Ash Allen</b></sub></a><br /><a href="#design-ash-jc-allen" title="Design">🎨</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://about.me/murrant"><img src="https://avatars.githubusercontent.com/u/39462?v=4?s=100" width="100px;" alt="Tony Murray"/><br /><sub><b>Tony Murray</b></sub></a><br /><a href="https://github.com/php-flasher/php-flasher/commits?author=murrant" title="Code">💻</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/n3wborn"><img src="https://avatars.githubusercontent.com/u/10246722?v=4?s=100" width="100px;" alt="Stéphane P"/><br /><sub><b>Stéphane P</b></sub></a><br /><a href="https://github.com/php-flasher/php-flasher/commits?author=n3wborn" title="Documentation">📖</a></td>
-    </tr>
-    <tr>
-      <td align="center" valign="top" width="14.28%"><a href="https://www.instagram.com/lucas.maciel_z"><img src="https://avatars.githubusercontent.com/u/80225404?v=4?s=100" width="100px;" alt="Lucas Maciel"/><br /><sub><b>Lucas Maciel</b></sub></a><br /><a href="#design-LucasStorm" title="Design">🎨</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://siek.io/"><img src="https://avatars.githubusercontent.com/u/5730766?v=4?s=100" width="100px;" alt="Antoni Siek"/><br /><sub><b>Antoni Siek</b></sub></a><br /><a href="https://github.com/php-flasher/php-flasher/commits?author=ImJustToNy" title="Code">💻</a></td>
-    </tr>
-  </tbody>
-</table>
+## Why PHPFlasher?
 
-<!-- markdownlint-restore -->
-<!-- prettier-ignore-end -->
+| | PHPFlasher | Others |
+|---|:---:|:---:|
+| **Zero JavaScript** | Write PHP only, frontend handled automatically | Requires manual JS setup |
+| **Auto Asset Injection** | CSS/JS injected automatically | Manual script tags needed |
+| **17 Built-in Themes** | Amazon, iOS, Slack, Material & more | Limited or no themes |
+| **4 Notification Libraries** | Toastr, SweetAlert, Noty, Notyf | Single library only |
+| **Livewire Integration** | Full event system support | Limited or none |
+| **RTL Support** | Built-in right-to-left | Often missing |
+| **Framework Agnostic** | Laravel, Symfony, or vanilla PHP | Framework-specific |
 
-<!-- ALL-CONTRIBUTORS-LIST:END -->
+---
 
-## Contact
+## Notification Types
 
-PHPFlasher is being actively developed by <a href="https://github.com/yoeunes">yoeunes</a>. 
-You can reach out with questions, bug reports, or feature requests on any of the following:
+```php
+flash()->success('Operation completed successfully!');
+flash()->error('Oops! Something went wrong.');
+flash()->warning('Please backup your data before continuing.');
+flash()->info('A new version is available for download.');
+```
 
-- [Github Issues](https://github.com/php-flasher/php-flasher/issues) 
-- [Github](https://github.com/yoeunes)
-- [Twitter](https://twitter.com/yoeunes)
-- [Linkedin](https://www.linkedin.com/in/younes-khoubza/)
-- [Email me directly](mailto:younes.khoubza@gmail.com)
+### With Titles
+
+```php
+flash()->success('Your changes have been saved.', 'Update Complete');
+flash()->error('Unable to connect to server.', 'Connection Failed');
+```
+
+### With Options
+
+```php
+flash()->success('Profile updated!', [
+    'position' => 'bottom-right',
+    'timeout' => 10000,
+]);
+```
+
+---
+
+## 17 Beautiful Themes
+
+PHPFlasher includes **17 professionally designed themes** ready to use:
+
+```php
+flash()->success('Welcome!', ['theme' => 'amazon']);
+flash()->success('Welcome!', ['theme' => 'ios']);
+flash()->success('Welcome!', ['theme' => 'slack']);
+flash()->success('Welcome!', ['theme' => 'material']);
+```
+
+<details>
+<summary><strong>View All Themes</strong></summary>
+
+| Theme | Style |
+|-------|-------|
+| `flasher` | Default clean design |
+| `amazon` | Amazon-inspired e-commerce |
+| `ios` | Apple iOS notifications |
+| `slack` | Slack messaging style |
+| `material` | Google Material Design |
+| `google` | Google notifications |
+| `facebook` | Facebook style |
+| `minimal` | Ultra-clean minimal |
+| `amber` | Warm amber tones |
+| `aurora` | Gradient effects |
+| `crystal` | Transparent design |
+| `emerald` | Modern green palette |
+| `jade` | Soft jade colors |
+| `neon` | Bright attention-grabbing |
+| `onyx` | Dark mode sleek |
+| `ruby` | Bold ruby accents |
+| `sapphire` | Elegant blue style |
+
+[**See all themes with live demos →**](https://php-flasher.io/themes)
+
+</details>
+
+---
+
+## Notification Libraries
+
+Need more features? Use popular notification libraries:
+
+### Toastr
+
+```bash
+composer require php-flasher/flasher-toastr-laravel
+```
+
+```php
+toastr()->success('Profile saved!', [
+    'positionClass' => 'toast-bottom-right',
+    'progressBar' => true,
+]);
+```
+
+### SweetAlert
+
+```bash
+composer require php-flasher/flasher-sweetalert-laravel
+```
+
+```php
+sweetalert()
+    ->showDenyButton()
+    ->showCancelButton()
+    ->warning('Do you want to save changes?');
+```
+
+### Noty
+
+```bash
+composer require php-flasher/flasher-noty-laravel
+```
+
+```php
+noty()->success('Data synchronized!', [
+    'layout' => 'topCenter',
+    'timeout' => 3000,
+]);
+```
+
+### Notyf
+
+```bash
+composer require php-flasher/flasher-notyf-laravel
+```
+
+```php
+notyf()->success('Upload complete!', [
+    'dismissible' => true,
+    'ripple' => true,
+]);
+```
+
+---
+
+## Livewire Integration
+
+PHPFlasher integrates seamlessly with Laravel Livewire:
+
+```php
+use Livewire\Attributes\On;
+
+class UserProfile extends Component
+{
+    public function save()
+    {
+        // Save logic...
+
+        sweetalert()
+            ->showDenyButton()
+            ->success('Save changes?');
+    }
+
+    #[On('sweetalert:confirmed')]
+    public function onConfirmed(array $payload): void
+    {
+        // User clicked confirm
+        $this->user->save();
+        flash()->success('Profile saved!');
+    }
+
+    #[On('sweetalert:denied')]
+    public function onDenied(array $payload): void
+    {
+        // User clicked deny
+    }
+}
+```
+
+[**Livewire documentation →**](https://php-flasher.io/livewire)
+
+---
+
+## Configuration
+
+### Laravel
+
+```php
+// config/flasher.php
+return [
+    'default' => 'flasher',
+    'themes' => [
+        'flasher' => [
+            'options' => [
+                'timeout' => 5000,
+                'position' => 'top-right',
+            ],
+        ],
+    ],
+];
+```
+
+### Symfony
+
+```yaml
+# config/packages/flasher.yaml
+flasher:
+    default: flasher
+    themes:
+        flasher:
+            options:
+                timeout: 5000
+                position: top-right
+```
+
+### Common Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `timeout` | int | `5000` | Auto-dismiss delay in ms (0 = sticky) |
+| `position` | string | `top-right` | `top-right`, `top-left`, `bottom-right`, `bottom-left`, `top-center`, `bottom-center` |
+| `closeButton` | bool | `true` | Show close button |
+| `progressBar` | bool | `true` | Show timeout progress bar |
+| `rtl` | bool | `false` | Right-to-left text direction |
+| `escapeHtml` | bool | `true` | Escape HTML in messages |
+
+---
+
+## Requirements
+
+| Requirement | Version |
+|-------------|---------|
+| PHP | >= 8.2 |
+| Laravel | >= 11.0 |
+| Symfony | >= 7.0 |
+
+---
+
+## Documentation
+
+For complete documentation, visit **[php-flasher.io](https://php-flasher.io)**
+
+- [Installation Guide](https://php-flasher.io/installation)
+- [Laravel Integration](https://php-flasher.io/laravel)
+- [Symfony Integration](https://php-flasher.io/symfony)
+- [Livewire Integration](https://php-flasher.io/livewire)
+- [Inertia.js Integration](https://php-flasher.io/inertia)
+- [Themes Gallery](https://php-flasher.io/themes)
+- [JavaScript Usage](https://php-flasher.io/javascript)
+
+---
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a [Pull Request](https://github.com/php-flasher/php-flasher/pulls).
+
+## Contributors
+
+<a href="https://github.com/php-flasher/php-flasher/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=php-flasher/php-flasher" alt="Contributors" />
+</a>
+
+---
+
+## Support the Project
+
+If PHPFlasher helps you build better applications, please consider:
+
+- **[Star this repository](https://github.com/php-flasher/php-flasher)** to show your support
+- **[Report bugs](https://github.com/php-flasher/php-flasher/issues)** to help improve the library
+- **[Share on Twitter](https://twitter.com/intent/tweet?text=Check%20out%20PHPFlasher%20-%20beautiful%20flash%20notifications%20for%20PHP!&url=https://github.com/php-flasher/php-flasher)** to spread the word
+
+---
 
 ## License
 
-PHPFlasher is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
+PHPFlasher is open-source software licensed under the [MIT license](LICENSE).
 
-<p align="center"> <b>Made with ❤️ by <a href="https://www.linkedin.com/in/younes-khoubza/">Younes KHOUBZA</a> </b> </p>
+<p align="center">
+    <br>
+    <strong>Made with ❤️ by <a href="https://github.com/yoeunes">Younes ENNAJI</a></strong>
+    <br><br>
+    <a href="https://github.com/php-flasher/php-flasher/stargazers">⭐ Star if you find this useful!</a>
+</p>

bin/assets

@@ -1,40 +1,675 @@
-#!/usr/bin/env php
-<?php
+#!/usr/bin/env bash
 
-require __DIR__ . '/../vendor/autoload.php';
+# =========================================================================
+# Build System for PHP-Flasher
+# =========================================================================
+#
+# This script provides an elegant build process for PHP-Flasher assets
+# with comprehensive reporting and flexible configuration options.
+#
+# Author: Younes ENNAJI
+# =========================================================================
 
-/** @var \Flasher\Prime\Plugin\PluginInterface[] $plugins */
-$plugins = array(
-    new \Flasher\Prime\Plugin\FlasherPlugin(),
-    new \Flasher\Noty\Prime\NotyPlugin(),
-    new \Flasher\Notyf\Prime\NotyfPlugin(),
-    new \Flasher\Pnotify\Prime\PnotifyPlugin(),
-    new \Flasher\SweetAlert\Prime\SweetAlertPlugin(),
-    new \Flasher\Toastr\Prime\ToastrPlugin(),
-);
+# Strict error handling
+set -o pipefail
 
-echo 'Downloading assets ...'. PHP_EOL;
+# =========================================================================
+# CONSTANTS AND CONFIGURATION
+# =========================================================================
 
-foreach ($plugins as $plugin) {
-    $scripts = $plugin->getScripts();
+# Colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly DIM='\033[2m'
+readonly UNDERLINE='\033[4m'
+readonly BLUE='\033[34m'
+readonly GREEN='\033[32m'
+readonly RED='\033[31m'
+readonly YELLOW='\033[33m'
+readonly CYAN='\033[36m'
+readonly MAGENTA='\033[35m'
+readonly WHITE='\033[37m'
 
-    foreach ($scripts['cdn'] as $index => $script) {
-        echo $script . PHP_EOL;
+# Emoji indicators
+readonly ROCKET="🚀"
+readonly PACKAGE="📦"
+readonly CHECK="✓"
+readonly ERROR="❌"
+readonly WARNING="⚠️"
+readonly HAMMER="🏗️"
+readonly CHART="📊"
+readonly SPARKLES="✨"
+readonly HOURGLASS="⏳"
+readonly PALETTE="🎨"
 
-        $path = $plugin->getAssetsDir() . '/'. pathinfo($script, PATHINFO_BASENAME);
-        $content = file_get_contents($script);
-        file_put_contents($path, $content);
-    }
+# File paths
+readonly SRC_DIR="src"
+readonly PRIME_PATH="${SRC_DIR}/Prime/Resources"
+readonly TEMP_DIR="/tmp/php-flasher-build-$$"
+readonly BUILD_LOG="${TEMP_DIR}/build.log"
+readonly SIZE_DATA="${TEMP_DIR}/sizes.data"
 
-    $styles = $plugin->getStyles();
+# Default configuration
+VERBOSE=false
+WATCH_MODE=false
+THEME_ONLY=false
+MODULE_ONLY=false
+ANALYZE=false
+DEEP_ANALYZE=false
+SKIP_CLEAR=false
+NODE_ENV="production"
 
-    foreach ($styles['cdn'] as $index => $script) {
-        echo $script . PHP_EOL;
+# =========================================================================
+# UTILITY FUNCTIONS
+# =========================================================================
 
-        $path = $plugin->getAssetsDir() . '/'. pathinfo($script, PATHINFO_BASENAME);
-        $content = file_get_contents($script);
-        file_put_contents($path, $content);
-    }
+cleanup() {
+    # Clean up temporary files when the script exits
+    rm -rf "${TEMP_DIR}" 2>/dev/null
 }
 
-echo 'DONE' . PHP_EOL;
+trap cleanup EXIT
+
+mkdir -p "${TEMP_DIR}"
+
+print_header() {
+    echo -e "\n${BOLD}Date      : ${RESET}${CYAN}$(date -u '+%Y-%m-%d %H:%M:%S') UTC${RESET}"
+    echo -e "${BOLD}User      : ${RESET}${MAGENTA}$(whoami)${RESET}"
+    echo -e "${BOLD}Branch    : ${RESET}${GREEN}$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")${RESET}"
+    echo -e "${BOLD}Directory : ${RESET}${BLUE}$(pwd)${RESET}"
+
+    if [ "$NODE_ENV" != "production" ]; then
+        echo -e "${BOLD}Mode      : ${RESET}${YELLOW}${NODE_ENV}${RESET}"
+    fi
+
+    if [ "$WATCH_MODE" = true ]; then
+        echo -e "${BOLD}Watch     : ${RESET}${CYAN}enabled${RESET}"
+    fi
+
+    if [ "$THEME_ONLY" = true ]; then
+        echo -e "${BOLD}Scope     : ${RESET}${MAGENTA}themes only${RESET}"
+    elif [ "$MODULE_ONLY" = true ]; then
+        echo -e "${BOLD}Scope     : ${RESET}${MAGENTA}modules only${RESET}"
+    fi
+
+    echo
+}
+
+print_section() {
+    echo -e "\n${BOLD}${CYAN}┌─ $1 ${2:-}${RESET}"
+}
+
+success_msg() {
+    echo -e "${GREEN}${CHECK} $*${RESET}"
+}
+
+error_msg() {
+    echo -e "${RED}${ERROR} $*${RESET}"
+}
+
+warning_msg() {
+    echo -e "${YELLOW}${WARNING} $*${RESET}"
+}
+
+info_msg() {
+    echo -e "${BLUE}${HOURGLASS} $*${RESET}"
+}
+
+print_usage() {
+    echo -e "${BOLD}Usage:${RESET} $0 [options]"
+    echo
+    echo -e "${BOLD}Options:${RESET}"
+    echo -e "  ${GREEN}-h, --help${RESET}        Show this help message"
+    echo -e "  ${GREEN}-v, --verbose${RESET}     Display detailed build output"
+    echo -e "  ${GREEN}-w, --watch${RESET}       Run in watch mode"
+    echo -e "  ${GREEN}-d, --development${RESET} Build in development mode (unminified)"
+    echo -e "  ${GREEN}-t, --themes-only${RESET} Build only themes"
+    echo -e "  ${GREEN}-m, --modules-only${RESET} Build only modules (core and plugins)"
+    echo -e "  ${GREEN}-a, --analyze${RESET}     Show detailed size analysis in table format"
+    echo -e "  ${GREEN}-D, --deep-analyze${RESET} Perform deep analysis of files (checksums, content inspection)"
+    echo -e "  ${GREEN}--skip-clear${RESET}      Skip clearing output directories"
+    echo
+}
+
+parse_args() {
+    while [ "$#" -gt 0 ]; do
+        case "$1" in
+            -h|--help)
+                print_usage
+                exit 0
+                ;;
+            -v|--verbose)
+                VERBOSE=true
+                ;;
+            -w|--watch)
+                WATCH_MODE=true
+                NODE_ENV="development"
+                ;;
+            -d|--development)
+                NODE_ENV="development"
+                ;;
+            -t|--themes-only)
+                THEME_ONLY=true
+                ;;
+            -m|--modules-only)
+                MODULE_ONLY=true
+                ;;
+            -a|--analyze)
+                ANALYZE=true
+                ;;
+            -D|--deep-analyze)
+                ANALYZE=true
+                DEEP_ANALYZE=true
+                ;;
+            --skip-clear)
+                SKIP_CLEAR=true
+                ;;
+            *)
+                warning_msg "Unknown option: $1"
+                print_usage
+                exit 1
+                ;;
+        esac
+        shift
+    done
+
+    # Validate conflicting options
+    if [ "$THEME_ONLY" = true ] && [ "$MODULE_ONLY" = true ]; then
+        error_msg "Cannot specify both --themes-only and --modules-only"
+        exit 1
+    fi
+
+    # Configure build mode
+    if [ "$WATCH_MODE" = true ]; then
+        ROLLUP_ARGS="-c -w"
+    else
+        ROLLUP_ARGS="-c"
+    fi
+
+    # When analyzing, we turn off verbosity for rollup
+    if [ "$ANALYZE" = true ]; then
+        export FILESIZE_SILENT=true
+    fi
+}
+
+# =========================================================================
+# BUILD FUNCTIONS
+# =========================================================================
+
+get_size_info() {
+    local file="$1"
+    # Get precise byte count for more accurate comparison
+    local bytes=$(wc -c < "$file")
+    local size=$(du -h "$file" | awk '{print $1}')
+    local gzip=$(gzip -c "$file" | wc -c | numfmt --to=iec --format="%.1f")
+    local brotli_size=$(brotli -c "$file" 2>/dev/null | wc -c | numfmt --to=iec --format="%.1f" || echo "N/A")
+
+    echo "$size|$gzip|$bytes|$brotli_size"
+}
+
+get_file_hash() {
+    local file="$1"
+    if command -v sha256sum &> /dev/null; then
+        sha256sum "$file" | awk '{print $1}'
+    elif command -v shasum &> /dev/null; then
+        shasum -a 256 "$file" | awk '{print $1}'
+    else
+        echo "HASH_UNAVAILABLE"
+    fi
+}
+
+analyze_file_content() {
+    local file="$1"
+    local filename=$(basename "$file")
+    local dir="${TEMP_DIR}/analysis/$(dirname "$file" | sed 's/\//_/g')"
+    mkdir -p "$dir"
+
+    # Get first 10 lines for a quick look
+    head -n 10 "$file" > "${dir}/${filename}.head"
+
+    # Get hash for exact comparison
+    local hash=$(get_file_hash "$file")
+    echo "$hash" > "${dir}/${filename}.hash"
+
+    # For CSS/JS, try to determine if it's minified
+    if [[ "$file" == *.css || "$file" == *.js ]]; then
+        # Count semicolons to help identify if minified
+        local semicolons=$(grep -o ";" "$file" | wc -l)
+        # Count newlines
+        local newlines=$(grep -c $'\n' "$file")
+
+        # Simple heuristic: if few newlines relative to semicolons, likely minified
+        if [ "$newlines" -lt 10 ] || [ "$semicolons" -gt "$((newlines * 5))" ]; then
+            echo "MINIFIED:YES semicolons:$semicolons newlines:$newlines" > "${dir}/${filename}.analysis"
+        else
+            echo "MINIFIED:NO semicolons:$semicolons newlines:$newlines" > "${dir}/${filename}.analysis"
+        fi
+    fi
+
+    echo "$hash"
+}
+
+collect_build_statistics() {
+    local modules_count=0
+    local themes_count=0
+    declare -a theme_names=()
+    local unique_css_hashes=0
+    local unique_js_hashes=0
+    declare -A css_hashes=()
+    declare -A js_hashes=()
+
+    # Create temporary directory for data
+    mkdir -p "${TEMP_DIR}/modules"
+    mkdir -p "${TEMP_DIR}/themes"
+    mkdir -p "${TEMP_DIR}/analysis"
+
+    echo "DEBUG: Looking for modules and themes..." >> "${BUILD_LOG}"
+
+    # Check for core flasher module first
+    if [ -f "${PRIME_PATH}/dist/flasher.min.js" ]; then
+        local size_info=$(get_size_info "${PRIME_PATH}/dist/flasher.min.js")
+        local hash="N/A"
+        if [ "$DEEP_ANALYZE" = true ]; then
+            hash=$(analyze_file_content "${PRIME_PATH}/dist/flasher.min.js")
+            js_hashes["$hash"]=1
+            ((unique_js_hashes++))
+        fi
+        echo "flasher:$size_info:$hash" >> "${TEMP_DIR}/modules/data"
+        ((modules_count++))
+    fi
+
+    # Collect module statistics - FIXED to avoid subshell issue
+    # Store filenames to process in a temporary file
+    find ${SRC_DIR}/*/Prime/Resources/dist -name "*.min.js" | grep -v themes > "${TEMP_DIR}/module_files.txt" 2>/dev/null
+
+    # Process each module file
+    while IFS= read -r file; do
+        local module=$(basename "$file" .min.js)
+        local size_info=$(get_size_info "$file")
+        local hash="N/A"
+        if [ "$DEEP_ANALYZE" = true ]; then
+            hash=$(analyze_file_content "$file")
+            js_hashes["$hash"]=1
+            ((unique_js_hashes++))
+        fi
+        echo "$module:$size_info:$hash" >> "${TEMP_DIR}/modules/data"
+        ((modules_count++))
+        echo "DEBUG: Found module: $module in $file (${size_info})" >> "${BUILD_LOG}"
+    done < "${TEMP_DIR}/module_files.txt"
+
+    # Collect theme statistics - FIXED to avoid subshell issue
+    if [ -d "${PRIME_PATH}/dist/themes" ]; then
+        # Store theme files in a temporary file
+        find ${PRIME_PATH}/dist/themes -name "*.min.js" > "${TEMP_DIR}/theme_files.txt" 2>/dev/null
+
+        # Process each theme file
+        while IFS= read -r file; do
+            local theme=$(basename "$(dirname "$file")")
+            local size_info=$(get_size_info "$file")
+            local js_hash="N/A"
+            local css_hash="N/A"
+
+            # Also get the CSS file size and analyze it
+            local css_file="${PRIME_PATH}/dist/themes/${theme}/${theme}.min.css"
+            local css_size_info="N/A"
+            if [ -f "$css_file" ]; then
+                css_size_info=$(get_size_info "$css_file")
+
+                if [ "$DEEP_ANALYZE" = true ]; then
+                    css_hash=$(analyze_file_content "$css_file")
+                    if [ -z "${css_hashes[$css_hash]}" ]; then
+                        css_hashes["$css_hash"]=1
+                        ((unique_css_hashes++))
+                    else
+                        css_hashes["$css_hash"]=$((css_hashes["$css_hash"] + 1))
+                    fi
+
+                    js_hash=$(analyze_file_content "$file")
+                    if [ -z "${js_hashes[$js_hash]}" ]; then
+                        js_hashes["$js_hash"]=1
+                    else
+                        js_hashes["$js_hash"]=$((js_hashes["$js_hash"] + 1))
+                    fi
+                fi
+
+                echo "DEBUG: Theme $theme JS: $size_info, CSS: $css_size_info" >> "${BUILD_LOG}"
+            else
+                echo "DEBUG: No CSS file found for theme $theme" >> "${BUILD_LOG}"
+            fi
+
+            echo "$theme:$size_info:$js_hash:$css_size_info:$css_hash" >> "${TEMP_DIR}/themes/data"
+            theme_names+=("$theme")
+            ((themes_count++))
+        done < "${TEMP_DIR}/theme_files.txt"
+
+        # Sort theme names alphabetically
+        if [ ${#theme_names[@]} -gt 0 ]; then
+            printf "%s\n" "${theme_names[@]}" | sort > "${TEMP_DIR}/theme_names"
+        fi
+    fi
+
+    # Store counts for summary
+    echo "$modules_count" > "${TEMP_DIR}/modules_count"
+    echo "$themes_count" > "${TEMP_DIR}/themes_count"
+    echo "$unique_js_hashes" > "${TEMP_DIR}/unique_js_hashes"
+    echo "$unique_css_hashes" > "${TEMP_DIR}/unique_css_hashes"
+
+    # Write hash statistics if deep analysis was enabled
+    if [ "$DEEP_ANALYZE" = true ]; then
+        echo "JS Hash Distribution:" > "${TEMP_DIR}/hash_stats.txt"
+        for hash in "${!js_hashes[@]}"; do
+            echo "  $hash: ${js_hashes[$hash]} files" >> "${TEMP_DIR}/hash_stats.txt"
+        done
+
+        echo -e "\nCSS Hash Distribution:" >> "${TEMP_DIR}/hash_stats.txt"
+        for hash in "${!css_hashes[@]}"; do
+            echo "  $hash: ${css_hashes[$hash]} files" >> "${TEMP_DIR}/hash_stats.txt"
+        done
+    fi
+}
+
+run_build() {
+    print_section "Starting Build Process" "${HAMMER}"
+
+    info_msg "Environment: ${NODE_ENV}"
+    info_msg "Building PHP-Flasher assets..."
+
+    # Set environment variables
+    export NODE_ENV="$NODE_ENV"
+    export ANALYZE="$ANALYZE"
+    export DEEP_ANALYZE="$DEEP_ANALYZE"
+
+    # Determine which parts to build based on flags
+    local rollup_args="$ROLLUP_ARGS"
+    if [ "$THEME_ONLY" = true ]; then
+        info_msg "Building themes only"
+        # Here we'd need to extend rollup to support theme-only builds
+        # For now, we'll complete the full build
+    elif [ "$MODULE_ONLY" = true ]; then
+        info_msg "Building modules only"
+        # Similarly, we'd need to extend rollup
+    fi
+
+    # Execute rollup with appropriate flags
+    if [ "$VERBOSE" = true ]; then
+        if npx rollup $rollup_args; then
+            success_msg "Build process completed"
+            return 0
+        else
+            error_msg "Build process failed"
+            return 1
+        fi
+    else
+        # Capture output for non-verbose mode
+        if npx rollup $rollup_args > "$BUILD_LOG" 2>&1; then
+            success_msg "Build process completed"
+            return 0
+        else
+            error_msg "Build process failed"
+            cat "$BUILD_LOG"
+            return 1
+        fi
+    fi
+}
+
+# =========================================================================
+# REPORTING FUNCTIONS
+# =========================================================================
+
+print_size_table() {
+    local title="$1"
+    local data_file="$2"
+    local max_name_len=20
+
+    if [ ! -f "$data_file" ] || [ ! -s "$data_file" ]; then
+        return
+    fi
+
+    echo -e "\n${BOLD}${WHITE}${title}${RESET}\n"
+
+    # Print table header with or without hashes based on deep analysis
+    if [ "$DEEP_ANALYZE" = true ]; then
+        printf "${BOLD}%-${max_name_len}s %-10s %-10s %-10s %-10s${RESET}\n" "Component" "Size" "Gzip" "Bytes" "Hash"
+    else
+        printf "${BOLD}%-${max_name_len}s %-10s %-10s %-10s${RESET}\n" "Component" "Size" "Gzip" "Bytes"
+    fi
+
+    echo -e "${DIM}$(printf '%.0s─' {1..70})${RESET}"
+
+    # Print table rows
+    while IFS=: read -r line; do
+        # Split the line into fields
+        local fields=()
+        while IFS=: read -ra parts; do
+            fields=("${parts[@]}")
+        done <<< "$line"
+
+        local name="${fields[0]}"
+        local size_data="${fields[1]}"
+        local hash="N/A"
+        if [ "${#fields[@]}" -gt 2 ]; then
+            hash="${fields[2]}"
+        fi
+
+        IFS='|' read -r size gzip bytes brotli <<< "$size_data"
+
+        if [ "$DEEP_ANALYZE" = true ]; then
+            printf "%-${max_name_len}s ${GREEN}%-10s${RESET} ${BLUE}%-10s${RESET} ${YELLOW}%-10s${RESET} ${DIM}%.8s${RESET}\n" \
+                "$name" "$size" "$gzip" "$bytes" "$hash"
+        else
+            printf "%-${max_name_len}s ${GREEN}%-10s${RESET} ${BLUE}%-10s${RESET} ${YELLOW}%-10s${RESET}\n" \
+                "$name" "$size" "$gzip" "$bytes"
+        fi
+    done < "$data_file"
+}
+
+print_theme_table() {
+    local data_file="$1"
+    local max_name_len=15
+
+    if [ ! -f "$data_file" ] || [ ! -s "$data_file" ]; then
+        return
+    fi
+
+    echo -e "\n${BOLD}${WHITE}Theme Sizes${RESET}\n"
+
+    # Print table header
+    printf "${BOLD}%-${max_name_len}s %-10s %-10s %-10s %-10s${RESET}\n" "Theme" "JS Size" "CSS Size" "JS Bytes" "CSS Bytes"
+    echo -e "${DIM}$(printf '%.0s─' {1..70})${RESET}"
+
+    # Print table rows
+    while IFS=: read -r line; do
+        # Split the line into fields
+        local fields=()
+        while IFS=: read -ra parts; do
+            fields=("${parts[@]}")
+        done <<< "$line"
+
+        local name="${fields[0]}"
+        local js_size_data="${fields[1]}"
+        local js_hash="N/A"
+        local css_size_data="N/A"
+        local css_hash="N/A"
+
+        if [ "${#fields[@]}" -gt 2 ]; then
+            js_hash="${fields[2]}"
+        fi
+
+        if [ "${#fields[@]}" -gt 3 ]; then
+            css_size_data="${fields[3]}"
+        fi
+
+        if [ "${#fields[@]}" -gt 4 ]; then
+            css_hash="${fields[4]}"
+        fi
+
+        IFS='|' read -r js_size js_gzip js_bytes js_brotli <<< "$js_size_data"
+
+        local css_size="N/A"
+        local css_bytes="N/A"
+
+        if [ "$css_size_data" != "N/A" ]; then
+            IFS='|' read -r css_size css_gzip css_bytes css_brotli <<< "$css_size_data"
+        fi
+
+        printf "%-${max_name_len}s ${GREEN}%-10s${RESET} ${MAGENTA}%-10s${RESET} ${YELLOW}%-10s${RESET} ${BLUE}%-10s${RESET}\n" \
+            "$name" "$js_size" "$css_size" "$js_bytes" "$css_bytes"
+    done < "$data_file"
+}
+
+print_theme_grid() {
+    local theme_names_file="$1"
+    if [ ! -f "$theme_names_file" ] || [ ! -s "$theme_names_file" ]; then
+        return
+    fi
+
+    echo -e "\n${BOLD}${MAGENTA}${PALETTE} Themes:${RESET}"
+
+    # Define grid parameters
+    local columns=3
+    local max_width=15
+    local count=0
+
+    # Print themes in a grid
+    while read -r theme; do
+        if [ $((count % columns)) -eq 0 ]; then
+            echo -ne "  "
+        fi
+
+        printf "• %-${max_width}s" "$theme"
+        count=$((count + 1))
+
+        if [ $((count % columns)) -eq 0 ]; then
+            echo
+        fi
+    done < "$theme_names_file"
+
+    # Add a newline if the last row wasn't complete
+    if [ $((count % columns)) -ne 0 ]; then
+        echo
+    fi
+}
+
+print_deep_analysis() {
+    if [ ! -d "${TEMP_DIR}/analysis" ]; then
+        return
+    fi
+
+    local unique_js=0
+    local unique_css=0
+
+    if [ -f "${TEMP_DIR}/unique_js_hashes" ]; then
+        unique_js=$(cat "${TEMP_DIR}/unique_js_hashes")
+    fi
+
+    if [ -f "${TEMP_DIR}/unique_css_hashes" ]; then
+        unique_css=$(cat "${TEMP_DIR}/unique_css_hashes")
+    fi
+
+    echo -e "\n${BOLD}${WHITE}Deep File Analysis${RESET}"
+    echo -e "${DIM}$(printf '%.0s─' {1..50})${RESET}"
+
+    echo -e "Unique JavaScript files: ${YELLOW}${unique_js}${RESET}"
+    echo -e "Unique CSS files: ${MAGENTA}${unique_css}${RESET}"
+
+    if [ -f "${TEMP_DIR}/hash_stats.txt" ]; then
+        echo -e "\n${BOLD}Hash Distribution:${RESET}"
+        local top_5=$(head -n 10 "${TEMP_DIR}/hash_stats.txt")
+        echo -e "${DIM}$top_5${RESET}"
+        echo -e "${DIM}(See ${TEMP_DIR}/hash_stats.txt for full details)${RESET}"
+    fi
+}
+
+print_summary() {
+    local success=$1
+    local duration=$2
+
+    # Read statistics
+    local modules_count=0
+    local themes_count=0
+
+    if [ -f "${TEMP_DIR}/modules_count" ]; then
+        modules_count=$(cat "${TEMP_DIR}/modules_count")
+    fi
+
+    if [ -f "${TEMP_DIR}/themes_count" ]; then
+        themes_count=$(cat "${TEMP_DIR}/themes_count")
+    fi
+
+    # Print summary header
+    echo -e "\n${BOLD}${PACKAGE} Build Summary${RESET}"
+    echo -e "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    # Print statistics
+    if [ "$MODULE_ONLY" = false ]; then
+        echo -e "${CHECK} Modules/Plugins:      ${BOLD}${CYAN}${modules_count}${RESET}"
+    fi
+
+    if [ "$THEME_ONLY" = false ]; then
+        echo -e "${CHECK} Themes:       ${BOLD}${MAGENTA}${themes_count}${RESET}"
+    fi
+
+    echo -e "${CHECK} Build completed in ${BOLD}${YELLOW}${duration}s${RESET}"
+
+    # Print theme names if available
+    if [ -f "${TEMP_DIR}/theme_names" ]; then
+        print_theme_grid "${TEMP_DIR}/theme_names"
+    fi
+
+    # Show size analysis if requested
+    if [ "$ANALYZE" = true ]; then
+        echo -e "\n${BOLD}${CHART} Size Analysis:${RESET}"
+        print_size_table "Module Sizes" "${TEMP_DIR}/modules/data"
+
+        if [ "$DEEP_ANALYZE" = true ]; then
+            print_theme_table "${TEMP_DIR}/themes/data"
+            print_deep_analysis
+        else
+            print_size_table "Theme Sizes" "${TEMP_DIR}/themes/data"
+        fi
+
+        # Add option to view detailed logs
+        echo -e "\nFor detailed build info, run: ${CYAN}cat $BUILD_LOG${RESET}"
+        echo -e "Temporary files at: ${CYAN}${TEMP_DIR}${RESET}"
+    fi
+}
+
+# =========================================================================
+# MAIN EXECUTION
+# =========================================================================
+
+main() {
+    local start_time=$(date +%s)
+    local build_success=true
+
+    # Parse command-line arguments
+    parse_args "$@"
+
+    # Show header
+    print_header
+
+    # Run the build process
+    run_build || build_success=false
+
+    # Only collect statistics if build was successful and not in watch mode
+    if [ "$WATCH_MODE" = false ] && [ "$build_success" = true ]; then
+        if [ "$ANALYZE" = true ] || [ ! -t 1 ]; then
+            print_section "Analyzing Build Output" "${CHART}"
+        fi
+        collect_build_statistics
+    fi
+
+    # Print summary (unless in watch mode)
+    if [ "$WATCH_MODE" = false ]; then
+        local end_time=$(date +%s)
+        local duration=$((end_time - start_time))
+
+        print_summary "$build_success" "$duration"
+    fi
+
+    # Exit with appropriate code
+    [ "$build_success" = true ] && exit 0 || exit 1
+}
+
+# Execute main function with all arguments
+main "$@"

bin/bump

@@ -0,0 +1,189 @@
+#!/usr/bin/env bash
+
+set -e
+set -o pipefail
+
+# Colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly BLUE='\033[34m'
+readonly GREEN='\033[32m'
+readonly RED='\033[31m'
+readonly YELLOW='\033[33m'
+
+# Emojis
+readonly ROCKET="🚀"
+readonly UPDATE="🔄"
+readonly PACKAGE="📦"
+readonly SUCCESS="✨"
+readonly ERROR="❌"
+readonly WARNING="⚠️"
+readonly CHECK="✓"
+
+# Header
+print_header() {
+    echo -e "\n${BOLD}${BLUE}╭──────────────────────────────────────────╮${RESET}"
+    echo -e "${BOLD}${BLUE}│     ${ROCKET} PHP-Flasher Version ${ROCKET}            │${RESET}"
+    echo -e "${BOLD}${BLUE}╰──────────────────────────────────────────╯${RESET}\n"
+    echo -e "    Date     : $(date -u '+%Y-%m-%d %H:%M:%S') UTC"
+    echo -e "    User     : $(whoami)"
+    echo -e "    Directory: $(pwd)\n"
+}
+
+# Version validation
+validate_version() {
+    local version=$1
+    if [[ ! $version =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+        echo -e "\n${RED}${ERROR} Invalid version format: $version${RESET}"
+        echo -e "    Version must be in format X.Y.Z (e.g., 2.1.6)\n"
+        exit 1
+    fi
+}
+
+# Get current version from Flasher class
+get_current_version() {
+    local file="src/Prime/Flasher.php"
+    if [ -f "$file" ]; then
+        local version=$(grep -o "const VERSION = '[0-9]\+\.[0-9]\+\.[0-9]\+'" "$file" | grep -o "[0-9]\+\.[0-9]\+\.[0-9]\+")
+        echo "$version"
+    else
+        echo -e "${RED}${ERROR} Flasher.php not found in src/Prime/Flasher.php${RESET}"
+        exit 1
+    fi
+}
+
+# Update composer.json file
+update_composer_file() {
+    local file=$1
+    local current_version=$2
+    local new_version=$3
+
+    # Create a temporary file
+    local tmp_file="${file}.tmp"
+
+    # Use jq with 4-space indentation
+    if command -v jq >/dev/null 2>&1; then
+        jq --indent 4 --arg cv "^${current_version}" --arg nv "^${new_version}" '
+            walk(
+                if type == "object" and has("require") then
+                    .require |= with_entries(
+                        if .key | startswith("php-flasher/") then
+                            .value = $nv
+                        else
+                            .
+                        end
+                    )
+                else
+                    .
+                end
+            )
+        ' "$file" > "$tmp_file"
+    else
+        # Fallback to sed for simple replacement
+        sed -E "s/\"php-flasher\/[^\"]+\": \"\\^${current_version}\"/\"\\0\": \"^${new_version}\"/" "$file" > "$tmp_file"
+    fi
+
+    # Check if the temporary file exists and has content
+    if [ -s "$tmp_file" ]; then
+        mv "$tmp_file" "$file"
+        echo "    ${CHECK} Updated $file"
+    else
+        echo "    ${WARNING} Failed to update $file"
+        rm -f "$tmp_file"
+    fi
+}
+
+# Update package.json file
+update_package_file() {
+    local file=$1
+    local current_version=$2
+    local new_version=$3
+
+    # Create a temporary file
+    local tmp_file="${file}.tmp"
+
+    # Use jq with 4-space indentation
+    if command -v jq >/dev/null 2>&1; then
+        jq --indent 4 --arg cv "^${current_version}" --arg nv "^${new_version}" --arg v "${new_version}" '
+            .version = $v |
+            if has("peerDependencies") then
+                .peerDependencies |= with_entries(
+                    if .key | startswith("@flasher/") then
+                        .value = $nv
+                    else
+                        .
+                    end
+                )
+            else
+                .
+            end |
+            if has("dependencies") then
+                .dependencies |= with_entries(
+                    if .key | startswith("@flasher/") then
+                        .value = $nv
+                    else
+                        .
+                    end
+                )
+            else
+                .
+            end
+        ' "$file" > "$tmp_file"
+    else
+        # Fallback to sed for simple replacement
+        sed -E -e "s/\"version\": \"${current_version}\"/\"version\": \"${new_version}\"/" \
+               -e "s/\"@flasher\/[^\"]+\": \"\\^${current_version}\"/\"\\0\": \"^${new_version}\"/" \
+               "$file" > "$tmp_file"
+    fi
+
+    # Check if the temporary file exists and has content
+    if [ -s "$tmp_file" ]; then
+        mv "$tmp_file" "$file"
+        echo "    ${CHECK} Updated $file"
+    else
+        echo "    ${WARNING} Failed to update $file"
+        rm -f "$tmp_file"
+    fi
+}
+
+# Update version in files
+update_version() {
+    local current_version=$1
+    local new_version=$2
+
+    echo -e " ${UPDATE} Updating version numbers ($current_version → $new_version)\n"
+
+    # Update PHP class version
+    echo -e " ${PACKAGE} Updating Flasher class version..."
+    if [ -f "src/Prime/Flasher.php" ]; then
+        sed -i '' "s/const VERSION = '$current_version'/const VERSION = '$new_version'/" src/Prime/Flasher.php
+        echo -e "    ${CHECK} Updated src/Prime/Flasher.php"
+    fi
+
+    # Update composer.json files in src directory
+    echo -e "\n ${PACKAGE} Updating composer.json files..."
+    find src -name "composer.json" -type f | while read -r file; do
+        update_composer_file "$file" "$current_version" "$new_version"
+    done
+
+    # Update package.json files in src directory
+    echo -e "\n ${PACKAGE} Updating package.json files..."
+    find src -name "package.json" -type f | while read -r file; do
+        update_package_file "$file" "$current_version" "$new_version"
+    done
+
+    echo -e "\n ${SUCCESS} Version bump complete!\n"
+}
+
+# Main execution
+if [ -z "$1" ]; then
+    echo -e "${RED}${ERROR} Version number is required${RESET}"
+    echo -e "Usage: $0 <version>\n"
+    exit 1
+fi
+
+print_header
+new_version=$1
+current_version=$(get_current_version)
+validate_version "$new_version"
+update_version "$current_version" "$new_version"

bin/copy

@@ -1,50 +1,35 @@
-#!/usr/bin/env php
-<?php
+#!/bin/bash
 
-$shared = realpath(__DIR__.'/../.shared');
+# Default to the current directory if no directory is provided
+dir=${1:-.}
 
-$resources = array(
-    $shared,
-    __DIR__.'/../.github/FUNDING.yml',
-    __DIR__.'/../README.md',
-    __DIR__.'/../LICENSE',
-);
+# Optional: A list of file extensions to filter by, e.g., "txt md". Leave empty to include all files.
+extensions=($2)
 
-$dirs = array(__DIR__.'/../packs', __DIR__.'/../src');
+# Temporary file to store results
+temp_file=$(mktemp)
 
-$packages = array_reduce($dirs, function ($files, $dir) {
-    return array_merge($files, glob("$dir/*/composer.json"), glob("$dir/*/*/composer.json"));
-}, array());
-
-foreach ($packages as $package) {
-    $package = realpath(dirname($package));
-    foreach ($resources as $resource) {
-        $resource = realpath($resource);
-        $dest = $package.str_replace(realpath(__DIR__.'/../'), '', $resource);
-
-        if (!is_dir($resource) && file_exists($resource)) {
-            copy($resource, $dest);
-            continue;
-        }
-
-        $files = new RecursiveIteratorIterator(
-            new RecursiveDirectoryIterator($resource, FilesystemIterator::SKIP_DOTS),
-            RecursiveIteratorIterator::SELF_FIRST
-        );
-
-        foreach ($files as $file) {
-            $target = $resource === $shared
-                ? $package.str_replace($resource, '', $file->getPathname())
-                : $dest .'/'. $file->getFilename();
-
-            if ($file->isDir()) {
-                system('rm -rf -- ' . escapeshellarg($dest));
-                @mkdir(dirname($target), 0777, true);
-                continue;
-            }
-
-            @mkdir(dirname($target), 0777, true);
-            @copy($file->getPathname(), $target);
-        }
-    }
+# Function to print file details (now inline within find command)
+print_file_details() {
+    echo "File Path: $1"
+    echo "Contents:"
+    cat "$1"
+    echo
 }
+
+# Finding and processing files
+if [ ${#extensions[@]} -eq 0 ]; then
+    # If no extensions are specified, process all files
+    find "$dir" -type f -exec bash -c 'echo "File Path: $1"; echo "Contents:"; cat "$1"; echo' bash {} \; >> "$temp_file"
+else
+    # Process only files with specified extensions
+    for ext in "${extensions[@]}"; do
+        find "$dir" -type f -name "*.$ext" -exec bash -c 'echo "File Path: $1"; echo "Contents:"; cat "$1"; echo' bash {} \; >> "$temp_file"
+    done
+fi
+
+# Copy results to clipboard and remove the temporary file
+cat "$temp_file" | pbcopy
+rm "$temp_file"
+
+echo "Results copied to clipboard."

bin/coverage

@@ -0,0 +1,129 @@
+#!/usr/bin/env bash
+
+set -o pipefail
+
+# PHP binary to use (defaults to PHP 8.2)
+PHP_BINARY="${PHP_BINARY:-/opt/homebrew/opt/php@8.2/bin/php}"
+
+# Colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly DIM='\033[2m'
+readonly BLUE='\033[34m'
+readonly GREEN='\033[32m'
+readonly RED='\033[31m'
+readonly YELLOW='\033[33m'
+readonly CYAN='\033[36m'
+readonly MAGENTA='\033[35m'
+
+# Essential emojis
+readonly ROCKET="🚀"
+readonly CHECK="✓"
+readonly ERROR="❌"
+readonly WARNING="⚠️"
+readonly CHART="📊"
+readonly TEST_TUBE="🧪"
+readonly SPARKLES="✨"
+readonly GLOBE="🌐"
+
+print_header() {
+    echo -e "\n${BOLD}${BLUE}${ROCKET} PHP-Flasher Test Coverage ${ROCKET}${RESET}\n"
+    echo -e "${BOLD}Date      : ${RESET}${CYAN}$(date -u '+%Y-%m-%d %H:%M:%S') UTC${RESET}"
+    echo -e "${BOLD}Directory : ${RESET}${BLUE}$(pwd)${RESET}\n"
+}
+
+cleanup_coverage() {
+    echo -e "${BOLD}${DIM}Cleaning up old coverage reports...${RESET}"
+    rm -rf coverage/phpunit coverage/vitest
+    mkdir -p coverage/phpunit coverage/vitest
+    echo -e "${CHECK} ${GREEN}Cleanup complete${RESET}\n"
+}
+
+run_phpunit_coverage() {
+    echo -e "${BOLD}${TEST_TUBE} Running PHPUnit with Coverage${RESET}"
+
+    if $PHP_BINARY vendor/bin/phpunit --coverage-html coverage/phpunit/html --coverage-text=coverage/phpunit/report.txt; then
+        echo -e "${CHECK} ${GREEN}PHPUnit coverage generated${RESET}"
+        echo -e "   ${DIM}HTML Report: coverage/phpunit/html/index.html${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}PHPUnit coverage generation failed${RESET}\n"
+        return 1
+    fi
+}
+
+run_vitest_coverage() {
+    echo -e "${BOLD}${TEST_TUBE} Running Vitest with Coverage${RESET}"
+
+    if npm run test:coverage; then
+        echo -e "${CHECK} ${GREEN}Vitest coverage generated${RESET}"
+        echo -e "   ${DIM}HTML Report: coverage/vitest/index.html${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}Vitest coverage generation failed${RESET}\n"
+        return 1
+    fi
+}
+
+print_summary() {
+    echo -e "${BOLD}${CYAN}${CHART} Coverage Reports Summary${RESET}\n"
+
+    echo -e "${BOLD}PHPUnit Coverage:${RESET}"
+    if [ -f "coverage/phpunit/html/index.html" ]; then
+        echo -e "  ${GREEN}${CHECK} HTML: ${RESET}coverage/phpunit/html/index.html"
+        if [ -f "coverage/phpunit/report.txt" ]; then
+            echo -e "  ${GREEN}${CHECK} Text: ${RESET}coverage/phpunit/report.txt"
+        fi
+    else
+        echo -e "  ${RED}${ERROR} No coverage report generated${RESET}"
+    fi
+
+    echo -e "\n${BOLD}Vitest Coverage:${RESET}"
+    if [ -f "coverage/vitest/index.html" ]; then
+        echo -e "  ${GREEN}${CHECK} HTML: ${RESET}coverage/vitest/index.html"
+        if [ -f "coverage/vitest/coverage-final.json" ]; then
+            echo -e "  ${GREEN}${CHECK} JSON: ${RESET}coverage/vitest/coverage-final.json"
+        fi
+    else
+        echo -e "  ${RED}${ERROR} No coverage report generated${RESET}"
+    fi
+
+    echo -e "\n${BOLD}${GLOBE} Open Reports:${RESET}"
+    echo -e "  ${CYAN}npm run coverage:open${RESET}"
+    echo -e "  ${DIM}Or manually open the HTML files in your browser${RESET}\n"
+}
+
+open_reports() {
+    if [ "$1" == "--open" ] || [ "$1" == "-o" ]; then
+        echo -e "${BOLD}${GLOBE} Opening coverage reports...${RESET}\n"
+
+        if [ -f "coverage/phpunit/html/index.html" ]; then
+            open coverage/phpunit/html/index.html 2>/dev/null || xdg-open coverage/phpunit/html/index.html 2>/dev/null
+        fi
+
+        if [ -f "coverage/vitest/index.html" ]; then
+            open coverage/vitest/index.html 2>/dev/null || xdg-open coverage/vitest/index.html 2>/dev/null
+        fi
+    fi
+}
+
+main() {
+    local start_time=$(date +%s)
+
+    print_header
+    cleanup_coverage
+    run_phpunit_coverage
+    run_vitest_coverage
+
+    local end_time=$(date +%s)
+    local duration=$((end_time - start_time))
+
+    print_summary
+
+    echo -e "${SPARKLES} ${BOLD}Coverage Complete${RESET}"
+    echo -e "Duration: ${YELLOW}${duration}s${RESET}\n"
+
+    open_reports "$1"
+}
+
+main "$@"

bin/docs

@@ -0,0 +1,101 @@
+#!/usr/bin/env bash
+
+set -o pipefail
+
+# Colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly DIM='\033[2m'
+readonly UNDERLINE='\033[4m'
+readonly BLUE='\033[34m'
+readonly GREEN='\033[32m'
+readonly RED='\033[31m'
+readonly YELLOW='\033[33m'
+readonly CYAN='\033[36m'
+readonly MAGENTA='\033[35m'
+
+# Essential emojis
+readonly ROCKET="🚀"
+readonly CHECK="✓"
+readonly ERROR="❌"
+readonly WARNING="⚠️"
+readonly BOOKS="📚"
+readonly HAMMER="🏗️"
+readonly SPARKLES="✨"
+
+print_header() {
+    echo -e "\n${BOLD}${BLUE}${ROCKET} PHP-Flasher Documentation Builder ${ROCKET}${RESET}\n"
+    echo -e "${BOLD}Date      : ${RESET}${CYAN}$(date -u '+%Y-%m-%d %H:%M:%S') UTC${RESET}"
+    echo -e "${BOLD}User      : ${RESET}${MAGENTA}yoeunes${RESET}"
+    echo -e "${BOLD}Branch    : ${RESET}${GREEN}$(git rev-parse --abbrev-ref HEAD)${RESET}"
+    echo -e "${BOLD}Directory : ${RESET}${BLUE}$(pwd)${RESET}\n"
+}
+
+install_dependencies() {
+    echo -e "${BOLD}${BOOKS} Installing dependencies${RESET}"
+
+    if npm install --force; then
+        echo -e "${CHECK} ${GREEN}Dependencies installed successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}Dependency installation had issues${RESET}\n"
+        return 1
+    fi
+}
+
+build_documentation() {
+    echo -e "${BOLD}${HAMMER} Building documentation${RESET}"
+
+    if npm run build; then
+        echo -e "${CHECK} ${GREEN}Documentation built successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${ERROR} ${RED}Documentation build failed${RESET}\n"
+        return 1
+    fi
+}
+
+main() {
+    local command=${1:-"build"}
+    local start_time=$(date +%s)
+    local success=true
+
+    # Change directory to docs/
+    if [[ ! -d "docs/" ]]; then
+        echo -e "${ERROR} ${RED}Documentation directory 'docs/' not found${RESET}\n"
+        exit 1
+    fi
+
+    cd docs/
+
+    print_header
+    echo -e "${BOLD}Command   : ${RESET}${CYAN}${command}${RESET}\n"
+
+    case $command in
+        "build")
+            install_dependencies || success=false
+            build_documentation || success=false
+            ;;
+        *)
+            echo -e "${ERROR} ${RED}Unknown command: ${command}${RESET}"
+            echo -e "Available commands: build"
+            exit 1
+            ;;
+    esac
+
+    local end_time=$(date +%s)
+    local duration=$((end_time - start_time))
+
+    # Summary
+    echo -e "${BOLD}${CYAN}Documentation ${command^} Summary${RESET}"
+    if [ "$success" = true ]; then
+        echo -e "${SPARKLES} ${GREEN}Documentation ${command} completed successfully${RESET}"
+    else
+        echo -e "${WARNING} ${YELLOW}Documentation ${command} completed with issues${RESET}"
+    fi
+    echo -e "Duration    : ${YELLOW}${duration}s${RESET}\n"
+
+    [ "$success" = true ] && exit 0 || exit 1
+}
+
+main "$@"

bin/lint

@@ -0,0 +1,174 @@
+#!/usr/bin/env bash
+
+set -o pipefail
+
+# PHP binary to use (defaults to PHP 8.2)
+PHP_BINARY="${PHP_BINARY:-/opt/homebrew/opt/php@8.2/bin/php}"
+
+# Colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly DIM='\033[2m'
+readonly UNDERLINE='\033[4m'
+readonly BLUE='\033[34m'
+readonly GREEN='\033[32m'
+readonly RED='\033[31m'
+readonly YELLOW='\033[33m'
+readonly CYAN='\033[36m'
+readonly MAGENTA='\033[35m'
+
+# Essential emojis
+readonly ROCKET="🚀"
+readonly CHECK="✓"
+readonly ERROR="❌"
+readonly WARNING="⚠️"
+readonly SEARCH="🔍"
+readonly PALETTE="🎨"
+readonly MICROSCOPE="🔬"
+readonly MEMO="📝"
+readonly MAGNIFIER="🔎"
+readonly TEST_TUBE="🧪"
+readonly SPARKLES="✨"
+
+print_header() {
+    echo -e "\n${BOLD}${BLUE}${ROCKET} PHP-Flasher Code Quality Check ${ROCKET}${RESET}\n"
+    echo -e "${BOLD}Date      : ${RESET}${CYAN}$(date -u '+%Y-%m-%d %H:%M:%S') UTC${RESET}"
+    echo -e "${BOLD}User      : ${RESET}${MAGENTA}yoeunes${RESET}"
+    echo -e "${BOLD}Branch    : ${RESET}${GREEN}$(git rev-parse --abbrev-ref HEAD)${RESET}"
+    echo -e "${BOLD}Directory : ${RESET}${BLUE}$(pwd)${RESET}\n"
+}
+
+run_rector() {
+    echo -e "${BOLD}${SEARCH} Running Rector${RESET}"
+
+    if $PHP_BINARY vendor/bin/rector; then
+        echo -e "${CHECK} ${GREEN}Rector completed successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}Rector found issues${RESET}\n"
+        return 1
+    fi
+}
+
+run_php_cs_fixer() {
+    echo -e "${BOLD}${PALETTE} Running PHP-CS-Fixer${RESET}"
+
+    if $PHP_BINARY vendor/bin/php-cs-fixer fix -v; then
+        echo -e "${CHECK} ${GREEN}PHP-CS-Fixer completed successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}CS-Fixer found issues${RESET}\n"
+        return 1
+    fi
+}
+
+run_phpstan() {
+    echo -e "${BOLD}${MICROSCOPE} Running PHPStan${RESET}"
+
+    if $PHP_BINARY vendor/bin/phpstan analyse --memory-limit=-1; then
+        echo -e "${CHECK} ${GREEN}PHPStan analysis completed successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}PHPStan found issues${RESET}\n"
+        return 1
+    fi
+}
+
+validate_composer_files() {
+    echo -e "${BOLD}${MEMO} Validating Composer Files${RESET}"
+    local validation_success=true
+
+    if ! composer validate --strict; then
+        echo -e "${WARNING} ${YELLOW}Main composer.json validation failed${RESET}"
+        validation_success=false
+    fi
+
+    # Find and validate all composer.json files in src/
+    find src/ -name "composer.json" | while read file; do
+        echo -e "${DIM}Validating ${file}${RESET}"
+        if ! composer validate --strict "$file"; then
+            echo -e "${WARNING} ${YELLOW}Package validation failed for ${file}${RESET}"
+            validation_success=false
+        fi
+    done
+
+    if [ "$validation_success" = true ]; then
+        echo -e "${CHECK} ${GREEN}All composer.json files are valid${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}Some composer.json files have issues${RESET}\n"
+        return 1
+    fi
+}
+
+run_phplint() {
+    echo -e "${BOLD}${MAGNIFIER} Running PHPLint${RESET}"
+
+    if $PHP_BINARY vendor/bin/phplint; then
+        echo -e "${CHECK} ${GREEN}PHPLint completed successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}PHPLint found issues${RESET}\n"
+        return 1
+    fi
+}
+
+run_phpunit() {
+    echo -e "${BOLD}${TEST_TUBE} Running PHPUnit Tests${RESET}"
+
+    if $PHP_BINARY vendor/bin/phpunit; then
+        echo -e "${CHECK} ${GREEN}All tests passed successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}Tests failed${RESET}\n"
+        return 1
+    fi
+}
+
+run_vitest() {
+    echo -e "${BOLD}${TEST_TUBE} Running Vitest Tests${RESET}"
+
+    if npm run test -- --run; then
+        echo -e "${CHECK} ${GREEN}Vitest tests passed successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}Vitest tests failed${RESET}\n"
+        return 1
+    fi
+}
+
+main() {
+    local start_time=$(date +%s)
+    local issues_found=false
+
+    print_header
+
+    # Run all quality tools
+    run_rector || issues_found=true
+    run_php_cs_fixer || issues_found=true
+    run_phpstan || issues_found=true
+    validate_composer_files || issues_found=true
+    run_phplint || issues_found=true
+    run_phpunit || issues_found=true
+    run_vitest || issues_found=true
+
+    local end_time=$(date +%s)
+    local duration=$((end_time - start_time))
+
+    # Summary
+    echo -e "${BOLD}${CYAN}Quality Check Summary${RESET}"
+    if [ "$issues_found" = true ]; then
+        echo -e "${WARNING} ${YELLOW}Quality check completed with issues${RESET}"
+    else
+        echo -e "${SPARKLES} ${GREEN}All quality checks passed successfully${RESET}"
+    fi
+    echo -e "Duration    : ${YELLOW}${duration}s${RESET}\n"
+
+    echo -e "${SPARKLES} ${BOLD}Quality Check Complete${RESET}"
+    echo -e "${CHECK} All checks finished\n"
+
+    # We don't exit with error code because the original task continues despite failures
+    exit 0
+}
+
+main

bin/npm

@@ -0,0 +1,225 @@
+#!/usr/bin/env bash
+
+# Set options
+set -o pipefail
+
+# Define colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly DIM='\033[2m'
+readonly GREEN='\033[32m'
+readonly BLUE='\033[34m'
+readonly CYAN='\033[36m'
+readonly YELLOW='\033[33m'
+readonly RED='\033[31m'
+
+# Define emoji
+readonly ROCKET="🚀"
+readonly NPM="📦"
+readonly CHECK="✓"
+readonly WARN="⚠️"
+readonly ERROR="❌"
+readonly LOADING="⏳"
+readonly SKIP="⏭️"
+
+# Configuration
+readonly NPM_PACKAGES=(
+    "src/Prime/Resources:@flasher/flasher"
+    "src/Noty/Prime/Resources:@flasher/flasher-noty"
+    "src/Notyf/Prime/Resources:@flasher/flasher-notyf"
+    "src/SweetAlert/Prime/Resources:@flasher/flasher-sweetalert"
+    "src/Toastr/Prime/Resources:@flasher/flasher-toastr"
+)
+
+# Print functions
+print_header() {
+    echo -e "\n${BOLD}${BLUE}╭──────────────────────────────────────────╮${RESET}"
+    echo -e "${BOLD}${BLUE}│     ${ROCKET} PHP-Flasher NPM Release ${ROCKET}        │${RESET}"
+    echo -e "${BOLD}${BLUE}╰──────────────────────────────────────────╯${RESET}\n"
+    echo -e "    ${DIM}Date     : $(date -u '+%Y-%m-%d %H:%M:%S') UTC${RESET}"
+    echo -e "    ${DIM}User     : $(whoami)${RESET}"
+    echo -e "    ${DIM}Directory: $(pwd)${RESET}"
+}
+
+print_section() {
+    echo -e "\n${BOLD}${CYAN}┌─ $1 ${2:-}${RESET}"
+}
+
+success_msg() {
+    echo -e "    ${GREEN}${CHECK} $*${RESET}"
+}
+
+info_msg() {
+    echo -e "    ${BLUE}${LOADING} $*${RESET}"
+}
+
+warning_msg() {
+    echo -e "    ${YELLOW}${WARN} $*${RESET}"
+}
+
+error_msg() {
+    echo -e "    ${RED}${ERROR} $*${RESET}"
+}
+
+skip_msg() {
+    echo -e "    ${YELLOW}${SKIP} $*${RESET}"
+}
+
+print_summary() {
+    local version=$1
+    local duration=$2
+    local success_count=$3
+    local skipped_count=$4
+    local failed_count=$5
+    local failed_packages=("${@:6}")
+
+    print_section "Release Summary"
+    echo -e "\n    ${DIM}Version   : ${BOLD}v${version}${RESET}"
+    echo -e "    ${DIM}Duration  : ${BOLD}${duration}s${RESET}"
+
+    if [ "$success_count" -gt 0 ]; then
+        echo -e "\n    ${DIM}Published : ${GREEN}${success_count}${RESET} packages"
+    fi
+
+    if [ "$skipped_count" -gt 0 ]; then
+        echo -e "\n    ${DIM}Skipped   : ${YELLOW}${skipped_count}${RESET} packages"
+    fi
+
+    if [ "$failed_count" -gt 0 ]; then
+        echo -e "\n    ${DIM}Failed    : ${RED}${failed_count}${RESET} packages"
+        echo -e "\n    ${DIM}Failed packages:${RESET}"
+        for package in "${failed_packages[@]}"; do
+            echo -e "        ${RED}• ${package}${RESET}"
+        done
+    fi
+
+    echo -e ""
+    if [ "$success_count" -eq 0 ] && [ "$skipped_count" -gt 0 ]; then
+        success_msg "All packages were already up to date! ${ROCKET}"
+    elif [ "$success_count" -gt 0 ]; then
+        success_msg "NPM release completed successfully! ${ROCKET}"
+    elif [ "$failed_count" -gt 0 ]; then
+        error_msg "NPM release completed with failures! ${ERROR}"
+    fi
+}
+
+# Check if version exists
+check_version_exists() {
+    local package=$1
+    local version=$2
+    npm view "${package}@${version}" version >/dev/null 2>&1
+}
+
+# Validate NPM is installed and logged in
+validate_npm() {
+    print_section "NPM Authentication Check"
+
+    if ! command -v npm >/dev/null 2>&1; then
+        error_msg "npm is not installed"
+        return 1
+    fi
+
+    if ! npm whoami >/dev/null 2>&1; then
+        error_msg "You are not logged in to npm. Please run 'npm login' first."
+        return 1
+    fi
+
+    success_msg "Authenticated as $(npm whoami)"
+    return 0
+}
+
+# Process a single package
+process_package() {
+    local path_and_name=$1
+    local version=$2
+    local path="${path_and_name%:*}"
+    local package="${path_and_name#*:}"
+
+    print_section "Processing ${package}"
+
+    if [ ! -d "$path" ]; then
+        warning_msg "Directory $path does not exist, skipping..."
+        return 2
+    fi
+
+    info_msg "Checking version ${version}..."
+    if check_version_exists "$package" "$version"; then
+        skip_msg "Version ${version} already exists for ${package}, skipping..."
+        return 2
+    fi
+
+    info_msg "Installing dependencies..."
+    (cd "$path" && npm install --silent) || {
+        error_msg "Failed to install dependencies"
+        return 1
+    }
+
+    info_msg "Updating package version..."
+    (cd "$path" && npm version "$version" --no-git-tag-version --allow-same-version >/dev/null 2>&1) || true
+
+    info_msg "Publishing ${package}@${version}..."
+    if (cd "$path" && npm publish --access public); then
+        success_msg "Successfully published ${package}@${version}"
+        return 0
+    else
+        error_msg "Failed to publish ${package}"
+        return 1
+    fi
+}
+
+# Main execution
+main() {
+    if [ "$#" -ne 1 ]; then
+        echo -e "\n${YELLOW}Usage: $0 <version>${RESET}"
+        echo -e "Example: $0 2.1.5\n"
+        exit 1
+    fi
+
+    local VERSION=$1
+    VERSION="${VERSION#v}"
+
+    print_header
+
+    # Validate npm authentication
+    validate_npm || exit 1
+
+    # Track statistics
+    local start_time=$(date +%s)
+    local success_count=0
+    local failed_count=0
+    local skipped_count=0
+    local failed_packages=()
+
+    # Process each package
+    for package_info in "${NPM_PACKAGES[@]}"; do
+        local package_name="${package_info#*:}"
+
+        process_package "$package_info" "$VERSION"
+        local status=$?
+
+        case $status in
+            0)
+                ((success_count++))
+                ;;
+            1)
+                ((failed_count++))
+                failed_packages+=("$package_name")
+                ;;
+            2)
+                ((skipped_count++))
+                ;;
+        esac
+    done
+
+    # Print summary
+    local end_time=$(date +%s)
+    local duration=$((end_time - start_time))
+
+    print_summary "$VERSION" "$duration" "$success_count" "$skipped_count" "$failed_count" "${failed_packages[@]}"
+
+    # Exit with failure if any package failed
+    [ "$failed_count" -gt 0 ] && exit 1 || exit 0
+}
+
+# Execute main function
+main "$@"

bin/release

@@ -1,83 +1,243 @@
 #!/usr/bin/env bash
 
-set -e
+set -o pipefail
 
-# Make sure the release tag is provided.
-if (( "$#" != 1 ))
-then
-    echo "Tag has to be provided."
+# Colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly DIM='\033[2m'
+readonly UNDERLINE='\033[4m'
+readonly BLUE='\033[34m'
+readonly GREEN='\033[32m'
+readonly RED='\033[31m'
+readonly YELLOW='\033[33m'
+readonly CYAN='\033[36m'
+readonly MAGENTA='\033[35m'
 
-    exit 1
-fi
+# Essential emojis
+readonly ROCKET="🚀"
+readonly CHECK="✓"
+readonly ERROR="❌"
+readonly SKIP="⏭️"
 
-RELEASE_BRANCH="main"
-CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
-VERSION=$1
+# Configuration
+readonly RELEASE_BRANCH="2.x"
+readonly REPOSITORIES=(
+    "flasher"
+    "flasher-laravel"
+    "flasher-symfony"
+    "flasher-noty"
+    "flasher-noty-laravel"
+    "flasher-noty-symfony"
+    "flasher-notyf"
+    "flasher-notyf-laravel"
+    "flasher-notyf-symfony"
+    "flasher-sweetalert"
+    "flasher-sweetalert-laravel"
+    "flasher-sweetalert-symfony"
+    "flasher-toastr"
+    "flasher-toastr-laravel"
+    "flasher-toastr-symfony"
+)
 
-# Make sure current branch and release branch match.
-if [[ "$RELEASE_BRANCH" != "$CURRENT_BRANCH" ]]
-then
-    echo "Release branch ($RELEASE_BRANCH) does not match the current active branch ($CURRENT_BRANCH)."
+print_header() {
+    echo -e "\n${BOLD}${BLUE}${ROCKET} PHP-Flasher Release ${ROCKET}${RESET}\n"
+    echo -e "${BOLD}Date      : ${RESET}${CYAN}$(date -u '+%Y-%m-%d %H:%M:%S') UTC${RESET}"
+    echo -e "${BOLD}User      : ${RESET}${MAGENTA}$(whoami)${RESET}"
+    echo -e "${BOLD}Branch    : ${RESET}${GREEN}$RELEASE_BRANCH${RESET}"
+    echo -e "${BOLD}Directory : ${RESET}${BLUE}$(pwd)${RESET}\n"
+}
 
-    exit 1
-fi
+draw_progress_bar() {
+    local percent=$1
+    local width=50
+    local filled=$(((width * percent + 99) / 100)) # Rounded up division
+    local empty=$((width - filled))
 
-# Make sure the working directory is clear.
-if [[ ! -z "$(git status --porcelain)" ]]
-then
-    echo "Your working directory is dirty. Did you forget to commit your changes?"
+    echo -n "["
+    printf "${GREEN}█%.0s${RESET}" $(seq 1 $filled)
+    printf "${DIM}─%.0s${RESET}" $(seq 1 $empty)
+    echo -n "] ${percent}%"
+}
 
-    exit 1
-fi
+check_tag_exists() {
+    local repo=$1
+    local tag=$2
+    local remote_url="git@github.com:php-flasher/$repo.git"
 
-# Make sure latest changes are fetched first.
-git fetch origin
+    if git ls-remote --tags "$remote_url" | grep -q "refs/tags/$tag$"; then
+        return 0
+    else
+        return 1
+    fi
+}
 
-# Make sure that release branch is in sync with origin.
-if [[ $(git rev-parse HEAD) != $(git rev-parse origin/$RELEASE_BRANCH) ]]
-then
-    echo "Your branch is out of date with its upstream. Did you forget to pull or push any changes before releasing?"
+release_repository() {
+    local repo=$1
+    local version=$2
+    local tmp_dir="/tmp/php-flasher"
+    local remote_url="git@github.com:php-flasher/$repo.git"
 
-    exit 1
-fi
+    echo -e "\nGitHub : ${UNDERLINE}${BLUE}https://github.com/php-flasher/${repo}${RESET}"
+    echo -e "Tag    : ${YELLOW}$version${RESET}"
 
-# Always prepend with "v"
-if [[ $VERSION != v*  ]]
-then
-    VERSION="v$VERSION"
-fi
+    if check_tag_exists "$repo" "$version"; then
+        echo -e "${SKIP} ${YELLOW}Tag $version already exists, skipping...${RESET}"
+        return 0
+    fi
 
-# Tag PHPFlasher
-git tag "$VERSION"
-git push origin --tags --force
+    # Clean and create temporary directory
+    rm -rf "$tmp_dir"
+    mkdir -p "$tmp_dir"
 
-# Tag Repositories
-for REMOTE in flasher flasher-laravel flasher-symfony \
-              flasher-toastr flasher-toastr-laravel flasher-toastr-symfony \
-              flasher-notyf flasher-notyf-laravel flasher-notyf-symfony \
-              flasher-sweetalert flasher-sweetalert-laravel flasher-sweetalert-symfony \
-              flasher-pnotify flasher-pnotify-laravel flasher-pnotify-symfony \
-              flasher-noty flasher-noty-laravel flasher-noty-symfony \
-              flasher-cli flasher-cli-laravel flasher-cli-symfony \
-              laravel-pack php-pack symfony-pack
-do
-    echo ""
-    echo ""
-    echo "Releasing $REMOTE";
-
-    TMP_DIR="/tmp/php-flasher"
-    REMOTE_URL="git@github.com:php-flasher/$REMOTE.git"
-
-    rm -rf $TMP_DIR;
-    mkdir $TMP_DIR;
+    echo -e "${CYAN}Cloning repository...${RESET}"
+    if ! git clone "$remote_url" "$tmp_dir" >/dev/null 2>&1; then
+        echo -e "${ERROR} ${RED}Failed to clone repository${RESET}"
+        return 1
+    fi
 
     (
-        cd $TMP_DIR;
+        cd "$tmp_dir"
+        echo -e "${CYAN}Creating tag $version...${RESET}"
+        git checkout "$RELEASE_BRANCH" >/dev/null 2>&1
+        git tag "$version"
 
-        git clone $REMOTE_URL .
-        git checkout "$RELEASE_BRANCH";
-
-        git tag "$VERSION"
-        git push origin --tags --force
+        if ! git push origin --tags --force >/dev/null 2>&1; then
+            echo -e "${ERROR} ${RED}Failed to push tag${RESET}"
+            return 1
+        fi
     )
-done
+
+    echo -e "${CHECK} ${GREEN}Successfully tagged${RESET}"
+    return 0
+}
+
+validate_version() {
+    local version=$1
+    if [[ ! $version =~ ^v?[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+        echo -e "\n${ERROR} ${RED}Invalid version format: $version${RESET}"
+        echo -e "Version must be in format X.Y.Z or vX.Y.Z (e.g., 2.1.6 or v2.1.6)\n"
+        exit 1
+    fi
+}
+
+validate_environment() {
+    echo -e "${CYAN}Validating environment...${RESET}"
+    local has_error=0
+
+    # Check branch
+    local current_branch=$(git rev-parse --abbrev-ref HEAD)
+    echo -ne "${CYAN}Checking branch...${RESET} "
+    if [[ "$RELEASE_BRANCH" != "$current_branch" ]]; then
+        echo -e "${ERROR} ${RED}Wrong branch: $current_branch (expected: $RELEASE_BRANCH)${RESET}"
+        has_error=1
+    else
+        echo -e "${CHECK} ${GREEN}On correct branch: $current_branch${RESET}"
+    fi
+
+    # Check working directory
+    echo -ne "${CYAN}Checking working directory...${RESET} "
+    if [[ ! -z "$(git status --porcelain)" ]]; then
+        echo -e "${ERROR} ${RED}Working directory is not clean${RESET}"
+        echo -e "${DIM}Hint: Commit or stash your changes first${RESET}"
+        has_error=1
+    else
+        echo -e "${CHECK} ${GREEN}Working directory is clean${RESET}"
+    fi
+
+    # Check sync with remote
+    echo -ne "${CYAN}Checking remote synchronization...${RESET} "
+    git fetch origin > /dev/null 2>&1
+    local local_sha=$(git rev-parse HEAD)
+    local remote_sha=$(git rev-parse origin/$RELEASE_BRANCH)
+
+    if [[ $local_sha != $remote_sha ]]; then
+        echo -e "${ERROR} ${RED}Branch is not in sync with origin/$RELEASE_BRANCH${RESET}"
+        echo -e "\n${YELLOW}Local  SHA: ${local_sha}${RESET}"
+        echo -e "${YELLOW}Remote SHA: ${remote_sha}${RESET}"
+        echo -e "\n${DIM}To fix this, try:${RESET}"
+
+        # Check if we have unpushed commits
+        if git rev-list origin/$RELEASE_BRANCH..$RELEASE_BRANCH --count > /dev/null 2>&1; then
+            local ahead=$(git rev-list origin/$RELEASE_BRANCH..$RELEASE_BRANCH --count)
+            local behind=$(git rev-list $RELEASE_BRANCH..origin/$RELEASE_BRANCH --count)
+
+            if [[ $ahead -gt 0 && $behind -gt 0 ]]; then
+                echo -e "${YELLOW}Your branch is $ahead commits ahead and $behind commits behind origin/$RELEASE_BRANCH${RESET}"
+                echo -e "1. ${CYAN}git pull origin $RELEASE_BRANCH${RESET} (to get remote changes)"
+                echo -e "2. ${CYAN}git push origin $RELEASE_BRANCH${RESET} (to push your changes)"
+            elif [[ $ahead -gt 0 ]]; then
+                echo -e "${YELLOW}Your branch is $ahead commits ahead of origin/$RELEASE_BRANCH${RESET}"
+                echo -e "Run: ${CYAN}git push origin $RELEASE_BRANCH${RESET}"
+            elif [[ $behind -gt 0 ]]; then
+                echo -e "${YELLOW}Your branch is $behind commits behind origin/$RELEASE_BRANCH${RESET}"
+                echo -e "Run: ${CYAN}git pull origin $RELEASE_BRANCH${RESET}"
+            fi
+        fi
+        has_error=1
+    else
+        echo -e "${CHECK} ${GREEN}Branch is in sync with remote${RESET}"
+    fi
+
+    if [[ $has_error -eq 1 ]]; then
+        echo -e "\n${ERROR} ${RED}Environment validation failed${RESET}"
+        exit 1
+    fi
+
+    echo -e "\n${CHECK} ${GREEN}Environment validated successfully${RESET}\n"
+}
+
+main() {
+    if [ "$#" -ne 1 ]; then
+        echo -e "${ERROR} ${RED}Version tag required${RESET}"
+        echo -e "Usage: $0 <version>"
+        echo -e "Example: $0 2.1.6\n"
+        exit 1
+    fi
+
+    local version=$1
+    [[ $version != v* ]] && version="v$version"
+
+    print_header
+    validate_version "$version"
+    validate_environment
+
+    local success_count=0
+    local skipped_count=0
+    local failed_count=0
+    local total_count=${#REPOSITORIES[@]}
+    local start_time=$(date +%s)
+
+    for repo in "${REPOSITORIES[@]}"; do
+        local current_count=$((success_count + skipped_count + failed_count + 1))
+        local percent=$((current_count * 100 / total_count))
+
+        echo -e "\nProgress: ${BOLD}$current_count/$total_count${RESET}"
+        # draw_progress_bar $percent
+
+        if release_repository "$repo" "$version"; then
+            if check_tag_exists "$repo" "$version"; then
+                ((skipped_count++))
+            else
+                ((success_count++))
+            fi
+        else
+            ((failed_count++))
+        fi
+    done
+
+    local end_time=$(date +%s)
+    local duration=$((end_time - start_time))
+
+    # Summary
+    echo -e "\n${BOLD}${CYAN}Release Summary${RESET}"
+    echo -e "Successful : ${GREEN}$success_count${RESET}"
+    echo -e "Skipped    : ${YELLOW}$skipped_count${RESET}"
+    [ $failed_count -gt 0 ] && echo -e "Failed     : ${RED}$failed_count${RESET}"
+    echo -e "Duration   : ${YELLOW}${duration}s${RESET}"
+    echo -e "Total repos: ${CYAN}$total_count${RESET}\n"
+
+    [ $failed_count -gt 0 ] && exit 1 || exit 0
+}
+
+main "$@"

bin/split

@@ -1,75 +1,154 @@
 #!/usr/bin/env bash
 
-# Set the "errexit" options
-set -o errexit
+set -o pipefail
 
-# Define colors and emoji for better visual feedback
-INDIGO='\033[0;94m'
-GREEN='\033[0;32m'
-NC='\033[0m' # No Color
-CHECK_MARK="✅"
-CROSS_MARK="❌"
+# Colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly DIM='\033[2m'
+readonly UNDERLINE='\033[4m'
+readonly BLUE='\033[34m'
+readonly GREEN='\033[32m'
+readonly RED='\033[31m'
+readonly YELLOW='\033[33m'
+readonly CYAN='\033[36m'
+readonly MAGENTA='\033[35m'
 
-# Define remotes
-REMOTES=(
-    'src/Prime:flasher'
-    'src/Laravel:flasher-laravel'
-    'src/Symfony:flasher-symfony'
+# Essential emojis
+readonly ROCKET="🚀"
+readonly CHECK="✓"
+readonly ERROR="❌"
 
-    'src/Toastr/Prime:flasher-toastr'
-    'src/Toastr/Laravel:flasher-toastr-laravel'
-    'src/Toastr/Symfony:flasher-toastr-symfony'
+# Repository mappings
+declare -A REPOSITORIES=(
+    # Core packages
+    ["src/Prime"]="flasher"
+    ["src/Laravel"]="flasher-laravel"
+    ["src/Symfony"]="flasher-symfony"
 
-    'src/Notyf/Prime:flasher-notyf'
-    'src/Notyf/Laravel:flasher-notyf-laravel'
-    'src/Notyf/Symfony:flasher-notyf-symfony'
+    # Toastr packages
+    ["src/Toastr/Prime"]="flasher-toastr"
+    ["src/Toastr/Laravel"]="flasher-toastr-laravel"
+    ["src/Toastr/Symfony"]="flasher-toastr-symfony"
 
-    'src/SweetAlert/Prime:flasher-sweetalert'
-    'src/SweetAlert/Laravel:flasher-sweetalert-laravel'
-    'src/SweetAlert/Symfony:flasher-sweetalert-symfony'
+    # Notyf packages
+    ["src/Notyf/Prime"]="flasher-notyf"
+    ["src/Notyf/Laravel"]="flasher-notyf-laravel"
+    ["src/Notyf/Symfony"]="flasher-notyf-symfony"
 
-    'src/Pnotify/Prime:flasher-pnotify'
-    'src/Pnotify/Laravel:flasher-pnotify-laravel'
-    'src/Pnotify/Symfony:flasher-pnotify-symfony'
+    # SweetAlert packages
+    ["src/SweetAlert/Prime"]="flasher-sweetalert"
+    ["src/SweetAlert/Laravel"]="flasher-sweetalert-laravel"
+    ["src/SweetAlert/Symfony"]="flasher-sweetalert-symfony"
 
-    'src/Noty/Prime:flasher-noty'
-    'src/Noty/Laravel:flasher-noty-laravel'
-    'src/Noty/Symfony:flasher-noty-symfony'
-
-    'src/Cli/Prime:flasher-cli'
-    'src/Cli/Laravel:flasher-cli-laravel'
-    'src/Cli/Symfony:flasher-cli-symfony'
-
-    'packs/laravel-pack:laravel-pack'
-    'packs/php-pack:php-pack'
-    'packs/symfony-pack:symfony-pack'
+    # Noty packages
+    ["src/Noty/Prime"]="flasher-noty"
+    ["src/Noty/Laravel"]="flasher-noty-laravel"
+    ["src/Noty/Symfony"]="flasher-noty-symfony"
 )
 
-# Define a function to split and push code to a remote repository
-function split() {
-    local prefix_and_remote="$1"
-    local prefix="${prefix_and_remote%:*}"
-    local remote="${prefix_and_remote#*:}"
-
-    # Add remote if it does not exist (ignoring errors silently)
-    if git remote add "$remote" "git@github.com:php-flasher/$remote.git" 2>/dev/null; then
-        echo -e "${GREEN}Added remote ${INDIGO}$remote${NC} ${CHECK_MARK}"
-    fi
-
-    # Split the code using the splitsh-lite utility
-    SHA1=$(./bin/splitsh-lite --prefix="$prefix")
-
-    # Push the code to the specified remote repository
-    git push "$remote" "$SHA1:refs/heads/main" -f
+print_header() {
+    echo -e "\n${BOLD}${BLUE}${ROCKET} PHP-Flasher Split ${ROCKET}${RESET}\n"
+    echo -e "${BOLD}Date      : ${RESET}${CYAN}$(date -u '+%Y-%m-%d %H:%M:%S') UTC${RESET}"
+    echo -e "${BOLD}User      : ${RESET}${MAGENTA}$(whoami)${RESET}"
+    echo -e "${BOLD}Branch    : ${RESET}${GREEN}$(git rev-parse --abbrev-ref HEAD)${RESET}"
+    echo -e "${BOLD}Directory : ${RESET}${BLUE}$(pwd)${RESET}\n"
 }
 
-# Pull the latest code from the origin repository
-echo -e "${INDIGO}Pulling the latest code from the origin repository...${NC}"
-git fetch origin main
+process_split() {
+    local prefix=$1
+    local remote=${REPOSITORIES[$prefix]}
+    local branch=$(git rev-parse --abbrev-ref HEAD)
+    local repo_url="https://github.com/php-flasher/${remote}"
+    local packagist_url="https://packagist.org/packages/php-flasher/${remote}"
 
-# Iterate over the remotes and split and push the code
-for remote in "${REMOTES[@]}"; do
-    split "$remote"
-done
+    echo -e "\nGitHub  : ${UNDERLINE}${BLUE}${repo_url}${RESET}"
+    echo -e "Package : ${UNDERLINE}${BLUE}${packagist_url}${RESET}"
+    echo -e "Prefix  : ${YELLOW}$prefix${RESET}"
+    echo -e "Branch  : ${GREEN}$branch${RESET}\n"
 
-echo -e "${GREEN}All done!${NC} ${CHECK_MARK}"
+    # Split the repository
+    echo -e "${CYAN}Splitting code...${RESET}"
+    local sha1
+    if ! sha1=$(./bin/splitsh-lite --prefix="$prefix" 2>/dev/null); then
+        echo -e "${ERROR} ${RED}Split failed${RESET}"
+        return 1
+    fi
+
+    echo -e "${CHECK} Split complete (SHA: ${YELLOW}${sha1:0:8}${RESET})"
+    echo -e "${CYAN}Pushing to remote...${RESET}"
+
+    if ! git push "$remote" "$sha1:refs/heads/$branch" -f > /dev/null 2>&1; then
+        echo -e "${ERROR} ${RED}Failed to push to $remote${RESET}"
+        return 1
+    fi
+
+    echo -e "${CHECK} ${GREEN}Pushed to $remote (branch: $branch)${RESET}"
+    return 0
+}
+
+update_repository() {
+    echo -e "\n${CYAN}Fetching latest changes...${RESET}"
+    if ! git fetch origin "$(git rev-parse --abbrev-ref HEAD)" > /dev/null 2>&1; then
+        echo -e "${ERROR} ${RED}Failed to fetch latest changes, continuing...${RESET}"
+    else
+        echo -e "${CHECK} ${GREEN}Repository updated successfully${RESET}"
+    fi
+    echo
+}
+
+draw_progress_bar() {
+    local percent=$1
+    local width=50
+    local filled=$(( (width * percent + 99) / 100 ))  # Rounded up division
+    local empty=$(( width - filled ))
+
+    echo -n "["
+    printf "${GREEN}█%.0s${RESET}" $(seq 1 $filled)
+    printf "${DIM}─%.0s${RESET}" $(seq 1 $empty)
+    echo -n "] ${percent}%"
+}
+
+main() {
+    print_header
+    update_repository
+
+    local success_count=0
+    local failed_count=0
+    local total_count=${#REPOSITORIES[@]}
+    local start_time=$(date +%s)
+
+    for prefix in "${!REPOSITORIES[@]}"; do
+        local current_count=$((success_count + failed_count + 1))
+        local percent=$((current_count * 100 / total_count))
+
+        echo -e "\nProgress: ${BOLD}$current_count/$total_count${RESET}"
+        # draw_progress_bar $percent
+
+        if process_split "$prefix"; then
+            ((success_count++))
+        else
+            ((failed_count++))
+        fi
+    done
+
+    local end_time=$(date +%s)
+    local duration=$((end_time - start_time))
+
+    # Summary
+    echo -e "\n${BOLD}${CYAN}Split Summary${RESET}"
+    echo -e "Successful  : ${GREEN}$success_count${RESET}"
+    [ $failed_count -gt 0 ] && echo -e "Failed      : ${RED}$failed_count${RESET}"
+    echo -e "Duration    : ${YELLOW}${duration}s${RESET}"
+    echo -e "Total repos : ${CYAN}$total_count${RESET}"
+
+    # Links
+    echo -e "\n${BOLD}${CYAN}Quick Links${RESET}"
+    echo -e "Packagist : ${UNDERLINE}${BLUE}https://packagist.org/packages/php-flasher/${RESET}"
+    echo -e "NPM       : ${UNDERLINE}${BLUE}https://www.npmjs.com/org/flasher${RESET}"
+    echo -e "GitHub    : ${UNDERLINE}${BLUE}https://github.com/php-flasher${RESET}\n"
+
+    [ $failed_count -gt 0 ] && exit 1 || exit 0
+}
+
+main

bin/status

@@ -0,0 +1,331 @@
+#!/usr/bin/env bash
+
+# Set options
+set -e
+set -o pipefail
+
+# Define colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly DIM='\033[2m'
+readonly ITALIC='\033[3m'
+readonly UNDERLINE='\033[4m'
+readonly RED='\033[31m'
+readonly GREEN='\033[32m'
+readonly YELLOW='\033[33m'
+readonly BLUE='\033[34m'
+readonly MAGENTA='\033[35m'
+readonly CYAN='\033[36m'
+readonly WHITE='\033[37m'
+
+# Define emoji
+readonly ROCKET="🚀"
+readonly PACKAGE="📦"
+readonly CALENDAR="📅"
+readonly CLOCK="🕒"
+readonly INFO="ℹ️"
+readonly WARNING="⚠️"
+readonly CHECK="✓"
+readonly BRANCH="🌿"
+readonly TAG="🏷️"
+readonly GITHUB="⭐"
+readonly STAR="⭐"
+readonly NPM="📦"
+readonly PACKAGIST="🎯"
+
+# Configuration
+readonly ORGANIZATION="php-flasher"
+readonly MAIN_BRANCH="2.x"
+readonly REPOSITORIES=(
+    "flasher"
+    "flasher-laravel"
+    "flasher-symfony"
+    "flasher-noty"
+    "flasher-noty-laravel"
+    "flasher-noty-symfony"
+    "flasher-notyf"
+    "flasher-notyf-laravel"
+    "flasher-notyf-symfony"
+    "flasher-sweetalert"
+    "flasher-sweetalert-laravel"
+    "flasher-sweetalert-symfony"
+    "flasher-toastr"
+    "flasher-toastr-laravel"
+    "flasher-toastr-symfony"
+)
+
+# Print functions
+print_header() {
+    echo -e "\n${BOLD}${BLUE}╭──────────────────────────────────────────╮${RESET}"
+    echo -e "${BOLD}${BLUE}│     ${ROCKET} PHP-Flasher Status ${ROCKET}             │${RESET}"
+    echo -e "${BOLD}${BLUE}╰──────────────────────────────────────────╯${RESET}\n"
+    echo -e "    ${DIM}Date     : $(date -u '+%Y-%m-%d %H:%M:%S') UTC${RESET}"
+    echo -e "    ${DIM}User     : $(whoami)${RESET}"
+    echo -e "    ${DIM}Directory: $(pwd)${RESET}"
+}
+
+print_section() {
+    echo -e "\n${BOLD}${CYAN} $1 ${2:-}${RESET}"
+}
+
+warning_msg() {
+    echo -e "    ${YELLOW}${WARNING} $*${RESET}"
+}
+
+success_msg() {
+    echo -e "    ${GREEN}${CHECK} $*${RESET}"
+}
+
+error_msg() {
+    echo -e "    ${RED}${ERROR} $*${RESET}"
+}
+
+info_msg() {
+    echo -e "${BLUE}${INFO} $*${RESET}"
+}
+
+# Get the latest tag for a repository
+get_latest_tag() {
+    local repo=$1
+    git ls-remote --tags --refs "git@github.com:${ORGANIZATION}/${repo}.git" |
+    sort -t '/' -k 3 -V |
+    tail -n1 |
+    awk -F/ '{print $3}'
+}
+
+# Get commit count since last tag
+get_commit_count_since_tag() {
+    local repo=$1
+    local tag=$2
+    git rev-list "${tag}..HEAD" --count 2>/dev/null || echo "0"
+}
+
+# Get repository statistics
+get_repo_stats() {
+    local repo=$1
+    local tmp_dir="/tmp/php-flasher-status/${repo}"
+
+    mkdir -p "$tmp_dir"
+    if [ ! -d "$tmp_dir/.git" ]; then
+        git clone -q "git@github.com:${ORGANIZATION}/${repo}.git" "$tmp_dir" 2>/dev/null
+    fi
+
+    (
+        cd "$tmp_dir"
+        git fetch -q origin 2>/dev/null
+        echo "$(git rev-parse --short HEAD)|$(git rev-parse --abbrev-ref HEAD)|$(git log -1 --format='%cr')|$(git log -1 --format='%s')"
+    )
+}
+
+# Check composer.json version
+check_composer_version() {
+    local file="composer.json"
+    if [ -f "$file" ]; then
+        grep -o '"version": *"[^"]*"' "$file" 2>/dev/null | cut -d'"' -f4 || echo "N/A"
+    else
+        echo "N/A"
+    fi
+}
+
+# Add curl with proper user agent for API calls
+curl_cmd() {
+    # You can set your GitHub token as an environment variable
+    local gh_token=${GITHUB_TOKEN:-""}
+    local auth_header=""
+    if [ ! -z "$gh_token" ]; then
+        auth_header="-H \"Authorization: token $gh_token\""
+    fi
+
+    curl -s -H "User-Agent: PHP-Flasher-Status-Check" $auth_header "$@"
+}
+
+# Get GitHub stars for a repository
+get_github_stars() {
+    local repo=$1
+    local response=$(curl_cmd "https://api.github.com/repos/${ORGANIZATION}/${repo}")
+    local stars=$(echo "$response" | grep -o '"stargazers_count":[0-9]*' | cut -d':' -f2)
+    echo "${stars:-0}"
+}
+
+# Get Packagist version
+get_packagist_version() {
+    local package=$1
+    local response=$(curl -s -f "https://repo.packagist.org/p2/php-flasher/${package}.json")
+    if [ $? -eq 0 ] && [ ! -z "$response" ]; then
+        local version=$(echo "$response" | grep -o '"latest":"[^"]*"' | cut -d'"' -f4)
+        if [ ! -z "$version" ]; then
+            echo "$version"
+        else
+            echo "N/A"
+        fi
+    else
+        echo "N/A"
+    fi
+}
+
+# Get NPM version
+get_npm_version() {
+    local package=$1
+    # Convert package name format
+    if [[ "$package" == "flasher" ]]; then
+        package="flasher"
+    elif [[ "$package" == *"-prime" ]]; then
+        # Remove -prime suffix for npm package name
+        package=${package%-prime}
+    elif [[ "$package" == *"-laravel" || "$package" == *"-symfony" ]]; then
+        # These packages don't have npm versions
+        echo "N/A"
+        return
+    fi
+
+    local response=$(curl_cmd "https://registry.npmjs.org/@flasher/${package}/latest")
+    local version=$(echo "$response" | grep -o '"version":"[^"]*"' | cut -d'"' -f4)
+    echo "${version:-N/A}"
+}
+
+# Display repository information
+display_repo_info() {
+    local repo=$1
+    local latest_tag=$(get_latest_tag "$repo")
+    local stats=($(get_repo_stats "$repo" | tr '|' ' '))
+    local github_stars=$(get_github_stars "$repo")
+    local npm_version="N/A"
+    local packagist_version="N/A"
+
+    # Get NPM version for specific packages
+    if [[ "$repo" == "flasher" || \
+          "$repo" == "flasher-noty" || \
+          "$repo" == "flasher-notyf" || \
+          "$repo" == "flasher-sweetalert" || \
+          "$repo" == "flasher-toastr" ]]; then
+        npm_version=$(get_npm_version "$repo")
+    fi
+
+    # Get Packagist version
+    packagist_version=$(get_packagist_version "$repo")
+
+    # Display repository information
+    echo -e "\n${BOLD}${MAGENTA} ${PACKAGE} ${repo}${RESET}"
+    echo -e "    ${BRANCH} Branch      : ${stats[1]:-unknown}"
+    echo -e "    ${TAG} Latest Tag  : ${latest_tag:-none}"
+    echo -e "    ${STAR} Stars       : ${github_stars}"
+    echo -e "    ${PACKAGIST} Packagist   : v${packagist_version}"
+
+    if [ "$npm_version" != "N/A" ]; then
+        echo -e "    ${NPM} NPM         : v${npm_version}"
+    fi
+
+    echo -e "    ${GITHUB} Last Commit : ${stats[0]:-unknown} (${stats[2]:-unknown})"
+    echo -e "    ${INFO} Message     : ${stats[3]:-unknown}"
+
+    local commits_since_tag=$(get_commit_count_since_tag "$repo" "$latest_tag")
+    if [ "$commits_since_tag" -gt 0 ]; then
+        warning_msg "$commits_since_tag commit(s) since last tag"
+    fi
+}
+
+# Check git status
+check_git_status() {
+    print_section "Git Status" "${GITHUB}"
+
+    local current_branch=$(git rev-parse --abbrev-ref HEAD)
+    echo -e "    ${BRANCH} Current Branch : ${current_branch}"
+
+    if [ "$current_branch" != "$MAIN_BRANCH" ]; then
+        warning_msg "    Not on main branch ($MAIN_BRANCH)"
+    fi
+
+    if [[ ! -z "$(git status --porcelain)" ]]; then
+        warning_msg "    Working directory is not clean"
+        git status --short | sed 's/^/        /'
+    else
+        success_msg "    Working directory is clean"
+    fi
+
+    local behind=$(git rev-list HEAD..origin/$current_branch --count 2>/dev/null || echo "0")
+    local ahead=$(git rev-list origin/$current_branch..HEAD --count 2>/dev/null || echo "0")
+
+    if [ "$behind" -gt 0 ]; then
+        warning_msg "    Branch is behind by $behind commit(s)"
+    fi
+    if [ "$ahead" -gt 0 ]; then
+        warning_msg "    Branch is ahead by $ahead commit(s)"
+    fi
+    if [ "$behind" -eq 0 ] && [ "$ahead" -eq 0 ]; then
+        success_msg "    Branch is up to date with origin"
+    fi
+}
+
+# Check dependencies
+check_dependencies() {
+    print_section "Dependencies" "${PACKAGE}"
+
+    if [ -f "composer.json" ]; then
+        echo -e "    ${BOLD}Composer Dependencies:${RESET}"
+        composer show | grep "php-flasher/" | sed 's/^/        /' || echo "        No PHP-Flasher dependencies found"
+    fi
+
+    if [ -f "package.json" ]; then
+        echo -e "\n    ${BOLD}NPM Dependencies:${RESET}"
+        npm list | grep "@flasher/" | sed 's/^/        /' || echo "        No Flasher dependencies found"
+    fi
+}
+
+# Display modified files
+display_modified_files() {
+    print_section "Modified Files" "📝"
+
+    local modified_files=$(git diff --name-only)
+    if [ ! -z "$modified_files" ]; then
+        echo -e "    ${BOLD}Modified files:${RESET}"
+        echo "$modified_files" | sed 's/^/        /'
+    else
+        success_msg "    No modified files"
+    fi
+}
+
+# Main execution
+main() {
+    print_header
+
+    # Check current repository status
+    check_git_status
+
+    # Check dependencies
+    check_dependencies
+
+    # Display modified files
+    display_modified_files
+
+    # Display repositories information
+    print_section "Repositories Status" "${PACKAGE}"
+    for repo in "${REPOSITORIES[@]}"; do
+        display_repo_info "$repo"
+    done
+
+    # Display release readiness
+    print_section "Release Readiness" "${ROCKET}"
+    local ready=true
+
+    if [ ! -z "$(git status --porcelain)" ]; then
+        warning_msg "Working directory is not clean"
+        ready=false
+    fi
+
+    if [ "$(git rev-parse --abbrev-ref HEAD)" != "$MAIN_BRANCH" ]; then
+        warning_msg "Not on main branch ($MAIN_BRANCH)"
+        ready=false
+    fi
+
+    if $ready; then
+        success_msg "Ready for release!"
+        echo -e "\n${BOLD}${GREEN}Suggested next steps:${RESET}"
+        echo -e "1. Run: ${ITALIC}./bin/split${RESET}"
+        echo -e "2. Run: ${ITALIC}./bin/release <version>${RESET}"
+    else
+        warning_msg "Not ready for release. Please fix the issues above."
+    fi
+}
+
+# Execute main function
+main

bin/update

@@ -0,0 +1,124 @@
+#!/usr/bin/env bash
+
+set -o pipefail
+
+# Colors and styles
+readonly RESET='\033[0m'
+readonly BOLD='\033[1m'
+readonly DIM='\033[2m'
+readonly UNDERLINE='\033[4m'
+readonly BLUE='\033[34m'
+readonly GREEN='\033[32m'
+readonly RED='\033[31m'
+readonly YELLOW='\033[33m'
+readonly CYAN='\033[36m'
+readonly MAGENTA='\033[35m'
+
+# Essential emojis
+readonly ROCKET="🚀"
+readonly CHECK="✓"
+readonly ERROR="❌"
+readonly PACKAGE="📦"
+readonly SEARCH="🔍"
+readonly HAMMER="🏗️"
+readonly SPARKLES="✨"
+readonly WARNING="⚠️"
+
+print_header() {
+    echo -e "\n${BOLD}${BLUE}${ROCKET} PHP-Flasher Update ${ROCKET}${RESET}\n"
+    echo -e "${BOLD}Date      : ${RESET}${CYAN}$(date -u '+%Y-%m-%d %H:%M:%S') UTC${RESET}"
+    echo -e "${BOLD}User      : ${RESET}${MAGENTA}$(whoami)${RESET}"
+    echo -e "${BOLD}Branch    : ${RESET}${GREEN}$(git rev-parse --abbrev-ref HEAD)${RESET}"
+    echo -e "${BOLD}Directory : ${RESET}${BLUE}$(pwd)${RESET}\n"
+}
+
+update_composer_dependencies() {
+    echo -e "${BOLD}${PACKAGE} Composer Dependencies${RESET}"
+
+    if composer update --prefer-lowest -W; then
+        echo -e "${CHECK} ${GREEN}Dependencies updated successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${ERROR} ${RED}Failed to update Composer dependencies${RESET}\n"
+        return 1
+    fi
+}
+
+check_npm_updates() {
+    echo -e "${BOLD}${SEARCH} NPM Updates Check${RESET}"
+
+    # Run the commands and capture their exit codes
+    ncu -u
+    NCU_EXIT_CODE=$?
+
+    npm run ncu --workspaces
+    NPM_EXIT_CODE=$?
+
+    # Check if both commands were successful
+    if [ $NCU_EXIT_CODE -eq 0 ] && [ $NPM_EXIT_CODE -eq 0 ]; then
+        echo -e "${CHECK} ${GREEN}NPM check completed successfully${RESET}\n"
+    else
+        echo -e "${WARNING} ${YELLOW}NPM check failed, continuing...${RESET}\n"
+    fi
+
+    return 0  # Continue regardless of outcome
+}
+
+update_npm_dependencies() {
+    echo -e "${BOLD}${PACKAGE} NPM Dependencies${RESET}"
+
+    if npm install --force; then
+        echo -e "${CHECK} ${GREEN}NPM dependencies installed successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}NPM install failed, continuing...${RESET}\n"
+        return 0  # Continue despite failure
+    fi
+}
+
+build_assets() {
+    echo -e "${BOLD}${HAMMER} Building Assets${RESET}"
+
+    if npm run build; then
+        echo -e "${CHECK} ${GREEN}Assets built successfully${RESET}\n"
+        return 0
+    else
+        echo -e "${WARNING} ${YELLOW}Build failed, continuing...${RESET}\n"
+        return 0  # Continue despite failure
+    fi
+}
+
+main() {
+    local start_time=$(date +%s)
+    local success=true
+
+    print_header
+
+    # Update composer dependencies
+    update_composer_dependencies || success=false
+
+    # Check NPM updates
+    check_npm_updates
+
+    # Update NPM dependencies
+    update_npm_dependencies
+
+    # Build assets
+    build_assets
+
+    local end_time=$(date +%s)
+    local duration=$((end_time - start_time))
+
+    # Summary
+    echo -e "${BOLD}${CYAN}Update Summary${RESET}"
+    if [ "$success" = true ]; then
+        echo -e "${SPARKLES} ${GREEN}Update completed successfully${RESET}"
+    else
+        echo -e "${WARNING} ${YELLOW}Update completed with some issues${RESET}"
+    fi
+    echo -e "Duration    : ${YELLOW}${duration}s${RESET}\n"
+
+    [ "$success" = true ] && exit 0 || exit 1
+}
+
+main

composer.json

@@ -1,121 +1,73 @@
 {
     "name": "php-flasher/php-flasher",
-    "description": "PHPFlasher - A powerful & easy-to-use package for adding flash messages to Laravel or Symfony projects. Provides feedback to users, improves engagement & enhances user experience. Intuitive design for beginners & experienced developers. A reliable, flexible solution.",
-    "license": "MIT",
     "type": "library",
-    "keywords": [
-        "php-flasher",
-        "flash-messages",
-        "notification-system",
-        "user-feedback",
-        "toastr",
-        "sweetalert",
-        "pnotify",
-        "noty",
-        "notyf",
-        "desktop-notifications",
-        "php",
-        "laravel",
-        "symfony",
-        "javascript",
-        "yoeunes",
-        "framework-agnostic",
-        "phpstorm-auto-complete",
-        "custom-adapter",
-        "user-experience",
-        "rtl",
-        "dark-mode"
-    ],
+    "license": "MIT",
+    "homepage": "https://php-flasher.io",
+    "description": "The core repository for PHPFlasher, hosting the source code, contributions, issue tracking, and discussions for the PHPFlasher project. This mono-repo serves as the hub for development and community engagement.",
+    "keywords": ["php", "flash-messages", "notifications", "phpflasher", "user-feedback", "open-source", "contributions", "discussions", "issue-tracking"],
+    "support": {
+        "issues": "https://github.com/php-flasher/php-flasher/issues",
+        "source": "https://github.com/php-flasher/php-flasher"
+    },
     "authors": [
         {
-            "name": "Younes KHOUBZA",
-            "email": "younes.khoubza@gmail.com",
-            "homepage": "https://www.linkedin.com/in/younes-khoubza",
+            "name": "Younes ENNAJI",
+            "email": "younes.ennaji.pro@gmail.com",
+            "homepage": "https://www.linkedin.com/in/younes--ennaji/",
             "role": "Developer"
         }
     ],
-    "require": {
-        "php": ">=5.3"
-    },
-    "require-dev": {
-        "ext-json": "*",
-        "ext-mbstring": "*",
-        "ergebnis/composer-normalize": "^2.31",
-        "friendsofphp/php-cs-fixer": "^3.17",
-        "illuminate/routing": "^4.0 || ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0 || ^11.0",
-        "illuminate/support": "^4.0 || ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0 || ^11.0",
-        "livewire/livewire": "^2.12.3 || ^3.0",
-        "orchestra/testbench": "^2.0 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.0",
-        "phpro/grumphp": "^1.16",
-        "phpstan/phpstan": "^1.10.16",
-        "phpunit/phpunit": "^10.2.1",
-        "symfony/config": "^2.0 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0",
-        "symfony/console": "^2.0 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0",
-        "symfony/dependency-injection": "^2.0 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0",
-        "symfony/framework-bundle": "^2.0 || ^3.0 || ^4.0 || ^5.0 || ^6.0",
-        "symfony/http-kernel": "^2.0 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0",
-        "symfony/translation": "^2.0 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0",
-        "symfony/twig-bundle": "^2.0 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0",
-        "symplify/monorepo-builder": "^11.2.3.72",
-        "vimeo/psalm": "^5.12"
-    },
-    "replace": {
-        "php-flasher/flasher": "self.version",
-        "php-flasher/flasher-cli": "self.version",
-        "php-flasher/flasher-cli-laravel": "self.version",
-        "php-flasher/flasher-cli-symfony": "self.version",
-        "php-flasher/flasher-laravel": "self.version",
-        "php-flasher/flasher-noty": "self.version",
-        "php-flasher/flasher-noty-laravel": "self.version",
-        "php-flasher/flasher-noty-symfony": "self.version",
-        "php-flasher/flasher-notyf": "self.version",
-        "php-flasher/flasher-notyf-laravel": "self.version",
-        "php-flasher/flasher-notyf-symfony": "self.version",
-        "php-flasher/flasher-pnotify": "self.version",
-        "php-flasher/flasher-pnotify-laravel": "self.version",
-        "php-flasher/flasher-pnotify-symfony": "self.version",
-        "php-flasher/flasher-sweetalert": "self.version",
-        "php-flasher/flasher-sweetalert-laravel": "self.version",
-        "php-flasher/flasher-sweetalert-symfony": "self.version",
-        "php-flasher/flasher-symfony": "self.version",
-        "php-flasher/flasher-toastr": "self.version",
-        "php-flasher/flasher-toastr-laravel": "self.version",
-        "php-flasher/flasher-toastr-symfony": "self.version"
-    },
     "minimum-stability": "dev",
     "prefer-stable": true,
+    "require": {
+        "php": ">=8.2",
+        "ext-intl": "*",
+        "illuminate/contracts": "^11.0|^12.0|^13.0",
+        "illuminate/routing": "^11.0|^12.0|^13.0",
+        "illuminate/support": "^11.0|^12.0|^13.0",
+        "laravel/octane": "^2.3",
+        "livewire/livewire": "^3.0",
+        "paragonie/random_compat": "^2.0",
+        "psr/container": "^1.1|^2.0",
+        "symfony/config": "^7.0|^8.0",
+        "symfony/console": "^7.0|^8.0",
+        "symfony/dependency-injection": "^7.0|^8.0",
+        "symfony/framework-bundle": "^7.0|^8.0",
+        "symfony/http-kernel": "^7.0|^8.0",
+        "symfony/translation": "^7.0|^8.0",
+        "symfony/twig-bundle": "^7.0|^8.0",
+        "symfony/ux-twig-component": "^2.19",
+        "yoeunes/regex-parser": "^1.0"
+    },
+    "require-dev": {
+        "larastan/larastan": "^2.9.9",
+        "mockery/mockery": "^1.6.12",
+        "orchestra/testbench": "^9.5.2",
+        "overtrue/phplint": "^9.5.3",
+        "php-cs-fixer/shim": "^3.64.0",
+        "phpstan/phpstan": "^1.12.7",
+        "phpstan/phpstan-mockery": "^1.1.3",
+        "phpstan/phpstan-phpunit": "^1.4.0",
+        "phpstan/phpstan-symfony": "^1.4.10",
+        "phpunit/phpunit": "^10.5.26",
+        "rector/rector": "^1.2.8",
+        "rector/swiss-knife": "^1.0.0",
+        "symplify/monorepo-builder": "^11.2.22"
+    },
     "autoload": {
         "psr-4": {
-            "Flasher\\": "src/",
-            "Flasher\\Cli\\Laravel\\": "src/Cli/Laravel/",
-            "Flasher\\Cli\\Prime\\": "src/Cli/Prime/",
-            "Flasher\\Cli\\Symfony\\": "src/Cli/Symfony/",
-            "Flasher\\Laravel\\": "src/Laravel/",
-            "Flasher\\Noty\\Laravel\\": "src/Noty/Laravel/",
-            "Flasher\\Noty\\Prime\\": "src/Noty/Prime/",
-            "Flasher\\Noty\\Symfony\\": "src/Noty/Symfony/",
-            "Flasher\\Notyf\\Laravel\\": "src/Notyf/Laravel/",
-            "Flasher\\Notyf\\Prime\\": "src/Notyf/Prime/",
-            "Flasher\\Notyf\\Symfony\\": "src/Notyf/Symfony/",
-            "Flasher\\Pnotify\\Laravel\\": "src/Pnotify/Laravel/",
-            "Flasher\\Pnotify\\Prime\\": "src/Pnotify/Prime/",
-            "Flasher\\Pnotify\\Symfony\\": "src/Pnotify/Symfony/",
-            "Flasher\\Prime\\": "src/Prime/",
-            "Flasher\\SweetAlert\\Laravel\\": "src/SweetAlert/Laravel/",
-            "Flasher\\SweetAlert\\Prime\\": "src/SweetAlert/Prime/",
-            "Flasher\\SweetAlert\\Symfony\\": "src/SweetAlert/Symfony/",
-            "Flasher\\Symfony\\": "src/Symfony/",
-            "Flasher\\Toastr\\Laravel\\": "src/Toastr/Laravel/",
-            "Flasher\\Toastr\\Prime\\": "src/Toastr/Prime/",
-            "Flasher\\Toastr\\Symfony\\": "src/Toastr/Symfony/"
+            "Flasher\\": "src/"
         },
         "files": [
-            "src/Cli/Prime/helpers.php",
-            "src/Noty/Prime/helpers.php",
-            "src/Notyf/Prime/helpers.php",
-            "src/Pnotify/Prime/helpers.php",
+            "src/Prime/functions.php",
             "src/Prime/helpers.php",
+            "src/Noty/Prime/functions.php",
+            "src/Noty/Prime/helpers.php",
+            "src/Notyf/Prime/functions.php",
+            "src/Notyf/Prime/helpers.php",
+            "src/SweetAlert/Prime/functions.php",
             "src/SweetAlert/Prime/helpers.php",
+            "src/Toastr/Prime/functions.php",
             "src/Toastr/Prime/helpers.php"
         ]
     },
@@ -125,40 +77,30 @@
         }
     },
     "config": {
-        "allow-plugins": {
-            "ergebnis/composer-normalize": true,
-            "kylekatarnls/update-helper": true,
-            "phpro/grumphp": true
-        },
         "preferred-install": "dist",
         "sort-packages": true
     },
     "extra": {
+        "phpstan": {
+            "includes": [
+                "extension.neon"
+            ]
+        },
         "laravel": {
-            "aliases": {
-                "Flasher": "Flasher\\Laravel\\Facade\\Flasher",
-                "Noty": "Flasher\\Laravel\\Facade\\Flasher",
-                "Notyf": "Flasher\\Notyf\\Laravel\\Facade\\Notyf",
-                "Pnotify": "Flasher\\Pnotify\\Laravel\\Facade\\Pnotify",
-                "SweetAlert": "Flasher\\SweetAlert\\Laravel\\Facade\\SweetAlert",
-                "Toastr": "Flasher\\Toastr\\Laravel\\Facade\\Toastr"
-            },
             "providers": [
-                "Flasher\\Cli\\Laravel\\FlasherCliServiceProvider",
-                "Flasher\\Toastr\\Laravel\\FlasherToastrServiceProvider",
                 "Flasher\\Laravel\\FlasherServiceProvider",
                 "Flasher\\Noty\\Laravel\\FlasherNotyServiceProvider",
-                "Flasher\\Pnotify\\Laravel\\FlasherPnotifyServiceProvider",
                 "Flasher\\Notyf\\Laravel\\FlasherNotyfServiceProvider",
-                "Flasher\\SweetAlert\\Laravel\\FlasherSweetAlertServiceProvider"
-            ]
+                "Flasher\\SweetAlert\\Laravel\\FlasherSweetAlertServiceProvider",
+                "Flasher\\Toastr\\Laravel\\FlasherToastrServiceProvider"
+            ],
+            "aliases": {
+                "Flasher": "Flasher\\Laravel\\Facade\\Flasher",
+                "Noty": "Flasher\\Noty\\Laravel\\Facade\\Noty",
+                "Notyf": "Flasher\\Notyf\\Laravel\\Facade\\Notyf",
+                "SweetAlert": "Flasher\\SweetAlert\\Laravel\\Facade\\SweetAlert",
+                "Toastr": "Flasher\\Toastr\\Laravel\\Facade\\Toastr"
+            }
         }
-    },
-    "scripts": {
-        "check-syntax": "test `find ./src -iname \"*.php\" | xargs -n1 -P6 php -l | grep -Fv \"No syntax errors\" | wc -l` -eq 0",
-        "lint": "git diff --staged | php ./vendor/bin/grumphp run",
-        "normalize-composer": "find src -name \"composer.json\" -exec composer normalize {} \\;",
-        "normalize-packs": "find packs -name \"composer.json\" -exec composer normalize {} \\;",
-        "validate-composer": "find src -name \"composer.json\" -exec composer validate --strict {} \\;"
     }
 }

demo/laravel/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[docker-compose.yml]
+indent_size = 4

demo/laravel/.env

@@ -0,0 +1,64 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=base64:mNtM4UEOfGE4dx7IAH4+kx4iPYPdGeu+Gaw/PIcF4II=
+APP_DEBUG=true
+APP_TIMEZONE=UTC
+APP_URL=http://localhost
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+APP_MAINTENANCE_STORE=database
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=sqlite
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_DATABASE=laravel
+# DB_USERNAME=root
+# DB_PASSWORD=
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+CACHE_PREFIX=
+
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_MAILER=log
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+MAIL_FROM_ADDRESS="hello@example.com"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"

demo/laravel/.env.example

@@ -0,0 +1,64 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_TIMEZONE=UTC
+APP_URL=http://localhost
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+APP_MAINTENANCE_STORE=database
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=sqlite
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_DATABASE=laravel
+# DB_USERNAME=root
+# DB_PASSWORD=
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+CACHE_PREFIX=
+
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_MAILER=log
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+MAIL_FROM_ADDRESS="hello@example.com"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"

demo/laravel/.gitattributes

@@ -0,0 +1,11 @@
+* text=auto eol=lf
+
+*.blade.php diff=html
+*.css diff=css
+*.html diff=html
+*.md diff=markdown
+*.php diff=php
+
+/.github export-ignore
+CHANGELOG.md export-ignore
+.styleci.yml export-ignore

demo/laravel/.gitignore

@@ -0,0 +1,19 @@
+/.phpunit.cache
+/node_modules
+/public/build
+/public/hot
+/public/vendor/flasher
+/public/storage
+/storage/*.key
+/vendor
+.env.backup
+.env.production
+.phpunit.result.cache
+Homestead.json
+Homestead.yaml
+auth.json
+npm-debug.log
+yarn-error.log
+/.fleet
+/.idea
+/.vscode

demo/laravel/.php-version

@@ -0,0 +1 @@
+8.3

demo/laravel/.valetrc

@@ -0,0 +1 @@
+php=php@8.2

demo/laravel/README.md

@@ -0,0 +1,66 @@
+<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p>
+
+<p align="center">
+<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a>
+</p>
+
+## About Laravel
+
+Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:
+
+- [Simple, fast routing engine](https://laravel.com/docs/routing).
+- [Powerful dependency injection container](https://laravel.com/docs/container).
+- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage.
+- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent).
+- Database agnostic [schema migrations](https://laravel.com/docs/migrations).
+- [Robust background job processing](https://laravel.com/docs/queues).
+- [Real-time event broadcasting](https://laravel.com/docs/broadcasting).
+
+Laravel is accessible, powerful, and provides tools required for large, robust applications.
+
+## Learning Laravel
+
+Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.
+
+You may also try the [Laravel Bootcamp](https://bootcamp.laravel.com), where you will be guided through building a modern Laravel application from scratch.
+
+If you don't feel like reading, [Laracasts](https://laracasts.com) can help. Laracasts contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.
+
+## Laravel Sponsors
+
+We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the [Laravel Partners program](https://partners.laravel.com).
+
+### Premium Partners
+
+- **[Vehikl](https://vehikl.com/)**
+- **[Tighten Co.](https://tighten.co)**
+- **[WebReinvent](https://webreinvent.com/)**
+- **[Kirschbaum Development Group](https://kirschbaumdevelopment.com)**
+- **[64 Robots](https://64robots.com)**
+- **[Curotec](https://www.curotec.com/services/technologies/laravel/)**
+- **[Cyber-Duck](https://cyber-duck.co.uk)**
+- **[DevSquad](https://devsquad.com/hire-laravel-developers)**
+- **[Jump24](https://jump24.co.uk)**
+- **[Redberry](https://redberry.international/laravel/)**
+- **[Active Logic](https://activelogic.com)**
+- **[byte5](https://byte5.de)**
+- **[OP.GG](https://op.gg)**
+
+## Contributing
+
+Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).
+
+## Code of Conduct
+
+In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).
+
+## Security Vulnerabilities
+
+If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed.
+
+## License
+
+The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

demo/laravel/app/Entity/Book.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Entity;
+
+readonly class Book
+{
+    public function __construct(private string $title)
+    {
+
+    }
+    public function getFlashIdentifier(): string
+    {
+        return sprintf('"%s" book', $this->title);
+    }
+}

demo/laravel/app/Http/Controllers/Controller.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace App\Http\Controllers;
+
+abstract class Controller
+{
+    //
+}

demo/laravel/app/Http/Controllers/DashboardController.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\Request;
+
+class DashboardController extends Controller
+{
+    /**
+     * Show the dashboard with overview of PHPFlasher features
+     */
+    public function index()
+    {
+        flash()->option('timeout', 10000)
+               ->info('Welcome to the PHPFlasher Laravel Demo! 👋 Explore different examples using the navigation.');
+
+        return view('dashboard');
+    }
+
+    /**
+     * Show all notification types at once
+     */
+    public function showAllTypes()
+    {
+        flash()->success('This is a success notification!');
+        flash()->info('This is an information notification!');
+        flash()->warning('This is a warning notification!');
+        flash()->error('This is an error notification!');
+
+        return redirect()->back();
+    }
+
+    /**
+     * Show theme selector
+     */
+    public function themeSelector()
+    {
+        return view('features.themes');
+    }
+
+    /**
+     * Display a notification with the selected theme
+     */
+    public function showTheme(Request $request)
+    {
+        $theme = $request->input('theme', 'default');
+
+        flash()
+            ->use("theme.$theme")
+            ->success("This notification uses the '$theme' theme!");
+
+        return redirect()->route('themes');
+    }
+}

demo/laravel/app/Http/Controllers/DemoController.php

@@ -0,0 +1,164 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+final class DemoController extends Controller
+{
+    public function home(): View
+    {
+        return view('home');
+    }
+
+    public function types(): View
+    {
+        return view('types');
+    }
+
+    public function themes(): View
+    {
+        return view('themes');
+    }
+
+    public function adapters(): View
+    {
+        return view('adapters');
+    }
+
+    public function positions(): View
+    {
+        return view('positions');
+    }
+
+    public function examples(): View
+    {
+        return view('examples');
+    }
+
+    public function playground(): View
+    {
+        return view('playground');
+    }
+
+    public function livewire(): View
+    {
+        return view('livewire');
+    }
+
+    public function notify(Request $request): JsonResponse
+    {
+        $type = $request->input('type', 'success');
+        $message = $request->input('message', 'Notification message');
+        $title = $request->input('title');
+        $theme = $request->input('theme');
+        $position = $request->input('position', 'top-right');
+        $timeout = (int) $request->input('timeout', 5000);
+
+        $flasher = flash();
+
+        // Apply theme if specified
+        if ($theme && $theme !== 'flasher') {
+            $flasher = $flasher->use("theme.{$theme}");
+        }
+
+        $options = [
+            'position' => $position,
+            'timeout' => $timeout,
+        ];
+
+        if ($title) {
+            $options['title'] = $title;
+        }
+
+        $flasher->{$type}($message, $options);
+
+        return response()->json(['success' => true]);
+    }
+
+    public function runExample(Request $request, string $scenario): JsonResponse
+    {
+        match ($scenario) {
+            'registration' => $this->registrationExample(),
+            'login_failed' => $this->loginFailedExample(),
+            'validation' => $this->validationExample(),
+            'shopping_cart' => $this->shoppingCartExample(),
+            'file_upload' => $this->fileUploadExample(),
+            'settings' => $this->settingsExample(),
+            'payment_success' => $this->paymentSuccessExample(),
+            'payment_failed' => $this->paymentFailedExample(),
+            'delete_confirm' => $this->deleteConfirmExample(),
+            'session_expiring' => $this->sessionExpiringExample(),
+            default => flash()->info('Example not found'),
+        };
+
+        return response()->json(['success' => true]);
+    }
+
+    private function registrationExample(): void
+    {
+        flash()->success('Welcome! Your account has been created.');
+        flash()->info('Please check your email to verify your account.');
+    }
+
+    private function loginFailedExample(): void
+    {
+        flash()->error('Invalid email or password.');
+        flash()->info('Forgot your password? Click here to reset.');
+    }
+
+    private function validationExample(): void
+    {
+        flash()->error('The email field is required.');
+        flash()->error('Password must be at least 8 characters.');
+        flash()->error('Please accept the terms and conditions.');
+    }
+
+    private function shoppingCartExample(): void
+    {
+        flash()->success('iPhone 15 Pro added to cart!');
+        flash()->warning('Only 2 items left in stock!');
+        flash()->info('Add $20 more for free shipping!');
+    }
+
+    private function fileUploadExample(): void
+    {
+        flash()->success('document.pdf uploaded successfully!');
+        flash()->info('File size: 2.4 MB');
+    }
+
+    private function settingsExample(): void
+    {
+        flash()->success('Settings saved successfully!');
+        flash()->info('Some changes may require a page refresh.');
+    }
+
+    private function paymentSuccessExample(): void
+    {
+        flash()->success('Payment of $149.99 confirmed!');
+        flash()->info('Order #12345 - Receipt sent to your email.');
+    }
+
+    private function paymentFailedExample(): void
+    {
+        flash()->error('Payment declined by your bank.');
+        flash()->warning('Please try a different payment method.');
+        flash()->info('Your cart has been saved.');
+    }
+
+    private function deleteConfirmExample(): void
+    {
+        flash()->warning('Are you sure? This action cannot be undone.');
+        flash()->info('Click confirm to delete or cancel to keep the item.');
+    }
+
+    private function sessionExpiringExample(): void
+    {
+        flash()->warning('Your session will expire in 5 minutes.');
+        flash()->info('Click anywhere to stay logged in.');
+    }
+}

demo/laravel/app/Http/Controllers/ExampleController.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Validator;
+
+class ExampleController extends Controller
+{
+    /**
+     * Form validation example
+     */
+    public function formExample()
+    {
+        return view('examples.form');
+    }
+
+    /**
+     * Process form submission
+     */
+    public function processForm(Request $request)
+    {
+        $validator = Validator::make($request->all(), [
+            'name' => 'required|min:2|max:50',
+            'email' => 'required|email',
+            'subject' => 'required|min:5',
+            'message' => 'required|min:10',
+        ]);
+
+        if ($validator->fails()) {
+            flash()->error('Please fix the errors in the form!');
+            return redirect()->back()
+                ->withErrors($validator)
+                ->withInput();
+        }
+
+        // Success scenario
+        flash()
+            ->success('Your message has been sent successfully!')
+            ->option('timeout', 8000);
+
+        return redirect()->route('form.example');
+    }
+
+    /**
+     * AJAX example page
+     */
+    public function ajaxExample()
+    {
+        return view('examples.ajax');
+    }
+
+    /**
+     * Process AJAX request
+     */
+    public function processAjax(Request $request)
+    {
+        $action = $request->input('action');
+        $success = rand(0, 10) > 3; // 70% success rate
+
+        if ($success) {
+            flash()->success("The $action action was completed successfully!");
+            return response()->json(['status' => 'success']);
+        } else {
+            flash()->error("The $action action failed. Please try again.");
+            return response()->json(['status' => 'error'], 422);
+        }
+    }
+
+    /**
+     * Demonstrate different notification positions
+     */
+    public function positionsExample()
+    {
+        return view('examples.positions');
+    }
+
+    /**
+     * Show notification at specified position
+     */
+    public function showAtPosition(Request $request)
+    {
+        $position = $request->input('position', 'top-right');
+
+        flash()
+            ->option('position', $position)
+            ->info("This notification appears at the '$position' position!");
+
+        return redirect()->route('positions.example');
+    }
+
+    /**
+     * Interactive playground to test notification options
+     */
+    public function playground()
+    {
+        return view('examples.playground');
+    }
+}

demo/laravel/app/Http/Middleware/HandleInertiaRequests.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Illuminate\Http\Request;
+use Inertia\Middleware;
+
+class HandleInertiaRequests extends Middleware
+{
+    /**
+     * The root template that's loaded on the first page visit.
+     *
+     * @see https://inertiajs.com/server-side-setup#root-template
+     *
+     * @var string
+     */
+    protected $rootView = 'app';
+
+    /**
+     * Determines the current asset version.
+     *
+     * @see https://inertiajs.com/asset-versioning
+     */
+    public function version(Request $request): ?string
+    {
+        return parent::version($request);
+    }
+
+    /**
+     * Define the props that are shared by default.
+     *
+     * @see https://inertiajs.com/shared-data
+     *
+     * @return array<string, mixed>
+     */
+    public function share(Request $request): array
+    {
+        return array_merge(parent::share($request), [
+            //
+        ]);
+    }
+}

demo/laravel/app/Livewire/ContactForm.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Livewire;
+
+use Livewire\Component;
+
+class ContactForm extends Component
+{
+    public string $name = '';
+    public string $email = '';
+    public string $message = '';
+
+    protected array $rules = [
+        'name' => 'required|min:2',
+        'email' => 'required|email',
+        'message' => 'required|min:10',
+    ];
+
+    public function submit(): void
+    {
+        $this->validate();
+
+        // Simulate form processing
+        flash()->success('Message sent successfully!');
+        flash()->info('We will respond within 24 hours.');
+
+        $this->reset(['name', 'email', 'message']);
+    }
+
+    public function render()
+    {
+        return view('livewire.contact-form');
+    }
+}

demo/laravel/app/Livewire/Counter.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Livewire;
+
+use Livewire\Component;
+
+class Counter extends Component
+{
+    public int $count = 0;
+
+    public function increment(): void
+    {
+        $this->count++;
+        flash()->success("Count increased to {$this->count}!");
+    }
+
+    public function decrement(): void
+    {
+        $this->count--;
+        flash()->warning("Count decreased to {$this->count}");
+    }
+
+    public function reset(): void
+    {
+        $this->count = 0;
+        flash()->info('Counter has been reset.');
+    }
+
+    public function render()
+    {
+        return view('livewire.counter');
+    }
+}

demo/laravel/app/Livewire/DeleteItem.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Livewire;
+
+use Livewire\Component;
+
+class DeleteItem extends Component
+{
+    protected $listeners = [
+        'sweetalert:confirmed' => 'onConfirmed',
+        'sweetalert:denied' => 'onDenied',
+    ];
+
+    public function confirmDelete(): void
+    {
+        sweetalert()
+            ->showDenyButton()
+            ->showCancelButton()
+            ->confirmButtonText('Yes, delete it!')
+            ->denyButtonText('Keep it')
+            ->warning('Are you sure you want to delete this item?');
+    }
+
+    public function onConfirmed(array $payload): void
+    {
+        // Simulate deletion
+        flash()->success('Item has been deleted successfully!');
+    }
+
+    public function onDenied(array $payload): void
+    {
+        flash()->info('The item was kept safe.');
+    }
+
+    public function render()
+    {
+        return view('livewire.delete-item');
+    }
+}

demo/laravel/app/Livewire/Eventous.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Livewire;
+
+use Livewire\Attributes\On;
+use Livewire\Component;
+
+class Eventous extends Component
+{
+    public function render()
+    {
+        return <<<'HTML'
+            <div>
+                <button wire:click="delete">delete</button>
+            </div>
+        HTML;
+    }
+
+    public function delete()
+    {
+        sweetalert()
+            ->showDenyButton()
+            ->info('confirm or deny action');
+    }
+
+    #[On('sweetalert:confirmed')]
+    public function onSweetalertConfirmed(array $payload): void
+    {
+        toastr()->success('sweetalert was confirmed');
+    }
+}

demo/laravel/app/Models/User.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Models;
+
+// use Illuminate\Contracts\Auth\MustVerifyEmail;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Foundation\Auth\User as Authenticatable;
+use Illuminate\Notifications\Notifiable;
+
+class User extends Authenticatable
+{
+    use HasFactory, Notifiable;
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array<int, string>
+     */
+    protected $fillable = [
+        'name',
+        'email',
+        'password',
+    ];
+
+    /**
+     * The attributes that should be hidden for serialization.
+     *
+     * @var array<int, string>
+     */
+    protected $hidden = [
+        'password',
+        'remember_token',
+    ];
+
+    /**
+     * Get the attributes that should be cast.
+     *
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'email_verified_at' => 'datetime',
+            'password' => 'hashed',
+        ];
+    }
+}

demo/laravel/app/Providers/AppServiceProvider.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Support\ServiceProvider;
+
+class AppServiceProvider extends ServiceProvider
+{
+    /**
+     * Register any application services.
+     */
+    public function register(): void
+    {
+        //
+    }
+
+    /**
+     * Bootstrap any application services.
+     */
+    public function boot(): void
+    {
+        //
+    }
+}

demo/laravel/artisan

@@ -0,0 +1,15 @@
+#!/usr/bin/env php
+<?php
+
+use Symfony\Component\Console\Input\ArgvInput;
+
+define('LARAVEL_START', microtime(true));
+
+// Register the Composer autoloader...
+require __DIR__.'/vendor/autoload.php';
+
+// Bootstrap Laravel and handle the command...
+$status = (require_once __DIR__.'/bootstrap/app.php')
+    ->handleCommand(new ArgvInput);
+
+exit($status);

demo/laravel/bootstrap/app.php

@@ -0,0 +1,24 @@
+<?php
+
+use Illuminate\Foundation\Application;
+use Illuminate\Foundation\Configuration\Exceptions;
+use Illuminate\Foundation\Configuration\Middleware;
+use Illuminate\Support\Facades\Route;
+
+return Application::configure(basePath: dirname(__DIR__))
+    ->withRouting(
+        web: __DIR__.'/../routes/web.php',
+        commands: __DIR__.'/../routes/console.php',
+        health: '/up',
+        then: function () {
+            Route::middleware('web')->group(base_path('routes/issues.php'));
+        },
+    )
+    ->withMiddleware(function (Middleware $middleware) {
+        $middleware->web(append: [
+            App\Http\Middleware\HandleInertiaRequests::class,
+        ]);
+    })
+    ->withExceptions(function (Exceptions $exceptions) {
+        //
+    })->create();

demo/laravel/bootstrap/cache/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

demo/laravel/bootstrap/providers.php

@@ -0,0 +1,5 @@
+<?php
+
+return [
+    App\Providers\AppServiceProvider::class,
+];

demo/laravel/composer.json

@@ -0,0 +1,87 @@
+{
+    "name": "laravel/laravel",
+    "type": "project",
+    "description": "The skeleton application for the Laravel framework.",
+    "keywords": ["laravel", "framework"],
+    "license": "MIT",
+    "repositories": [
+        {
+            "type": "path",
+            "url": "../..",
+            "options": {
+                "symlink": true
+            }
+        }
+    ],
+    "require": {
+        "php": "^8.3",
+        "inertiajs/inertia-laravel": "^2.0",
+        "laravel/framework": "^13.0",
+        "laravel/tinker": "^3.0",
+        "livewire/livewire": "^3.6",
+        "php-flasher/php-flasher": "@dev",
+        "spatie/laravel-csp": "^3.23",
+        "spatie/laravel-ray": "^1.40"
+    },
+    "require-dev": {
+        "barryvdh/laravel-debugbar": "^4.1",
+        "fakerphp/faker": "^1.24",
+        "larastan/larastan": "^3.2",
+        "laravel/pint": "^1.21",
+        "laravel/sail": "^1.41",
+        "mockery/mockery": "^1.6",
+        "nunomaduro/collision": "^8.7",
+        "pestphp/pest": "^4.0",
+        "pestphp/pest-plugin-laravel": "^4.0",
+        "spatie/laravel-ignition": "^2.9",
+        "spatie/ray": "^1.41"
+    },
+    "autoload": {
+        "psr-4": {
+            "App\\": "app/",
+            "Database\\Factories\\": "database/factories/",
+            "Database\\Seeders\\": "database/seeders/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests/"
+        }
+    },
+    "scripts": {
+        "post-autoload-dump": [
+            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
+            "@php artisan package:discover --ansi",
+            "@php artisan flasher:install"
+        ],
+        "post-update-cmd": [
+            "@php artisan vendor:publish --tag=laravel-assets --ansi --force",
+            "@php artisan flasher:install"
+        ],
+        "post-root-package-install": [
+            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\"",
+            "@php artisan flasher:install"
+        ],
+        "post-create-project-cmd": [
+            "@php artisan key:generate --ansi",
+            "@php -r \"file_exists('database/database.sqlite') || touch('database/database.sqlite');\"",
+            "@php artisan migrate --graceful --ansi"
+        ]
+    },
+    "extra": {
+        "laravel": {
+            "dont-discover": []
+        }
+    },
+    "config": {
+        "optimize-autoloader": true,
+        "preferred-install": "dist",
+        "sort-packages": true,
+        "allow-plugins": {
+            "pestphp/pest-plugin": true,
+            "php-http/discovery": true
+        }
+    },
+    "minimum-stability": "stable",
+    "prefer-stable": true
+}

demo/laravel/config/app.php

@@ -0,0 +1,126 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Name
+    |--------------------------------------------------------------------------
+    |
+    | This value is the name of your application, which will be used when the
+    | framework needs to place the application's name in a notification or
+    | other UI elements where an application name needs to be displayed.
+    |
+    */
+
+    'name' => env('APP_NAME', 'Laravel'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Environment
+    |--------------------------------------------------------------------------
+    |
+    | This value determines the "environment" your application is currently
+    | running in. This may determine how you prefer to configure various
+    | services the application utilizes. Set this in your ".env" file.
+    |
+    */
+
+    'env' => env('APP_ENV', 'production'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Debug Mode
+    |--------------------------------------------------------------------------
+    |
+    | When your application is in debug mode, detailed error messages with
+    | stack traces will be shown on every error that occurs within your
+    | application. If disabled, a simple generic error page is shown.
+    |
+    */
+
+    'debug' => (bool) env('APP_DEBUG', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application URL
+    |--------------------------------------------------------------------------
+    |
+    | This URL is used by the console to properly generate URLs when using
+    | the Artisan command line tool. You should set this to the root of
+    | the application so that it's available within Artisan commands.
+    |
+    */
+
+    'url' => env('APP_URL', 'http://localhost'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Timezone
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify the default timezone for your application, which
+    | will be used by the PHP date and date-time functions. The timezone
+    | is set to "UTC" by default as it is suitable for most use cases.
+    |
+    */
+
+    'timezone' => env('APP_TIMEZONE', 'UTC'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Locale Configuration
+    |--------------------------------------------------------------------------
+    |
+    | The application locale determines the default locale that will be used
+    | by Laravel's translation / localization methods. This option can be
+    | set to any locale for which you plan to have translation strings.
+    |
+    */
+
+    'locale' => env('APP_LOCALE', 'en'),
+
+    'fallback_locale' => env('APP_FALLBACK_LOCALE', 'en'),
+
+    'faker_locale' => env('APP_FAKER_LOCALE', 'en_US'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Encryption Key
+    |--------------------------------------------------------------------------
+    |
+    | This key is utilized by Laravel's encryption services and should be set
+    | to a random, 32 character string to ensure that all encrypted values
+    | are secure. You should do this prior to deploying the application.
+    |
+    */
+
+    'cipher' => 'AES-256-CBC',
+
+    'key' => env('APP_KEY'),
+
+    'previous_keys' => [
+        ...array_filter(
+            explode(',', env('APP_PREVIOUS_KEYS', ''))
+        ),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Maintenance Mode Driver
+    |--------------------------------------------------------------------------
+    |
+    | These configuration options determine the driver used to determine and
+    | manage Laravel's "maintenance mode" status. The "cache" driver will
+    | allow maintenance mode to be controlled across multiple machines.
+    |
+    | Supported drivers: "file", "cache"
+    |
+    */
+
+    'maintenance' => [
+        'driver' => env('APP_MAINTENANCE_DRIVER', 'file'),
+        'store' => env('APP_MAINTENANCE_STORE', 'database'),
+    ],
+
+];

demo/laravel/config/auth.php

@@ -0,0 +1,115 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Authentication Defaults
+    |--------------------------------------------------------------------------
+    |
+    | This option defines the default authentication "guard" and password
+    | reset "broker" for your application. You may change these values
+    | as required, but they're a perfect start for most applications.
+    |
+    */
+
+    'defaults' => [
+        'guard' => env('AUTH_GUARD', 'web'),
+        'passwords' => env('AUTH_PASSWORD_BROKER', 'users'),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Authentication Guards
+    |--------------------------------------------------------------------------
+    |
+    | Next, you may define every authentication guard for your application.
+    | Of course, a great default configuration has been defined for you
+    | which utilizes session storage plus the Eloquent user provider.
+    |
+    | All authentication guards have a user provider, which defines how the
+    | users are actually retrieved out of your database or other storage
+    | system used by the application. Typically, Eloquent is utilized.
+    |
+    | Supported: "session"
+    |
+    */
+
+    'guards' => [
+        'web' => [
+            'driver' => 'session',
+            'provider' => 'users',
+        ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | User Providers
+    |--------------------------------------------------------------------------
+    |
+    | All authentication guards have a user provider, which defines how the
+    | users are actually retrieved out of your database or other storage
+    | system used by the application. Typically, Eloquent is utilized.
+    |
+    | If you have multiple user tables or models you may configure multiple
+    | providers to represent the model / table. These providers may then
+    | be assigned to any extra authentication guards you have defined.
+    |
+    | Supported: "database", "eloquent"
+    |
+    */
+
+    'providers' => [
+        'users' => [
+            'driver' => 'eloquent',
+            'model' => env('AUTH_MODEL', App\Models\User::class),
+        ],
+
+        // 'users' => [
+        //     'driver' => 'database',
+        //     'table' => 'users',
+        // ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Resetting Passwords
+    |--------------------------------------------------------------------------
+    |
+    | These configuration options specify the behavior of Laravel's password
+    | reset functionality, including the table utilized for token storage
+    | and the user provider that is invoked to actually retrieve users.
+    |
+    | The expiry time is the number of minutes that each reset token will be
+    | considered valid. This security feature keeps tokens short-lived so
+    | they have less time to be guessed. You may change this as needed.
+    |
+    | The throttle setting is the number of seconds a user must wait before
+    | generating more password reset tokens. This prevents the user from
+    | quickly generating a very large amount of password reset tokens.
+    |
+    */
+
+    'passwords' => [
+        'users' => [
+            'provider' => 'users',
+            'table' => env('AUTH_PASSWORD_RESET_TOKEN_TABLE', 'password_reset_tokens'),
+            'expire' => 60,
+            'throttle' => 60,
+        ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Password Confirmation Timeout
+    |--------------------------------------------------------------------------
+    |
+    | Here you may define the amount of seconds before a password confirmation
+    | window expires and users are asked to re-enter their password via the
+    | confirmation screen. By default, the timeout lasts for three hours.
+    |
+    */
+
+    'password_timeout' => env('AUTH_PASSWORD_TIMEOUT', 10800),
+
+];

demo/laravel/config/cache.php

@@ -0,0 +1,107 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Cache Store
+    |--------------------------------------------------------------------------
+    |
+    | This option controls the default cache store that will be used by the
+    | framework. This connection is utilized if another isn't explicitly
+    | specified when running a cache operation inside the application.
+    |
+    */
+
+    'default' => env('CACHE_STORE', 'database'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Cache Stores
+    |--------------------------------------------------------------------------
+    |
+    | Here you may define all of the cache "stores" for your application as
+    | well as their drivers. You may even define multiple stores for the
+    | same cache driver to group types of items stored in your caches.
+    |
+    | Supported drivers: "apc", "array", "database", "file", "memcached",
+    |                    "redis", "dynamodb", "octane", "null"
+    |
+    */
+
+    'stores' => [
+
+        'array' => [
+            'driver' => 'array',
+            'serialize' => false,
+        ],
+
+        'database' => [
+            'driver' => 'database',
+            'table' => env('DB_CACHE_TABLE', 'cache'),
+            'connection' => env('DB_CACHE_CONNECTION'),
+            'lock_connection' => env('DB_CACHE_LOCK_CONNECTION'),
+        ],
+
+        'file' => [
+            'driver' => 'file',
+            'path' => storage_path('framework/cache/data'),
+            'lock_path' => storage_path('framework/cache/data'),
+        ],
+
+        'memcached' => [
+            'driver' => 'memcached',
+            'persistent_id' => env('MEMCACHED_PERSISTENT_ID'),
+            'sasl' => [
+                env('MEMCACHED_USERNAME'),
+                env('MEMCACHED_PASSWORD'),
+            ],
+            'options' => [
+                // Memcached::OPT_CONNECT_TIMEOUT => 2000,
+            ],
+            'servers' => [
+                [
+                    'host' => env('MEMCACHED_HOST', '127.0.0.1'),
+                    'port' => env('MEMCACHED_PORT', 11211),
+                    'weight' => 100,
+                ],
+            ],
+        ],
+
+        'redis' => [
+            'driver' => 'redis',
+            'connection' => env('REDIS_CACHE_CONNECTION', 'cache'),
+            'lock_connection' => env('REDIS_CACHE_LOCK_CONNECTION', 'default'),
+        ],
+
+        'dynamodb' => [
+            'driver' => 'dynamodb',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+            'table' => env('DYNAMODB_CACHE_TABLE', 'cache'),
+            'endpoint' => env('DYNAMODB_ENDPOINT'),
+        ],
+
+        'octane' => [
+            'driver' => 'octane',
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Cache Key Prefix
+    |--------------------------------------------------------------------------
+    |
+    | When utilizing the APC, database, memcached, Redis, and DynamoDB cache
+    | stores, there might be other applications using the same cache. For
+    | that reason, you may prefix every cache key to avoid collisions.
+    |
+    */
+
+    'prefix' => env('CACHE_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_').'_cache_'),
+
+];

demo/laravel/config/database.php

@@ -0,0 +1,170 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Database Connection Name
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify which of the database connections below you wish
+    | to use as your default connection for database operations. This is
+    | the connection which will be utilized unless another connection
+    | is explicitly specified when you execute a query / statement.
+    |
+    */
+
+    'default' => env('DB_CONNECTION', 'sqlite'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Database Connections
+    |--------------------------------------------------------------------------
+    |
+    | Below are all of the database connections defined for your application.
+    | An example configuration is provided for each database system which
+    | is supported by Laravel. You're free to add / remove connections.
+    |
+    */
+
+    'connections' => [
+
+        'sqlite' => [
+            'driver' => 'sqlite',
+            'url' => env('DB_URL'),
+            'database' => env('DB_DATABASE', database_path('database.sqlite')),
+            'prefix' => '',
+            'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true),
+        ],
+
+        'mysql' => [
+            'driver' => 'mysql',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '3306'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'unix_socket' => env('DB_SOCKET', ''),
+            'charset' => env('DB_CHARSET', 'utf8mb4'),
+            'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'strict' => true,
+            'engine' => null,
+            'options' => extension_loaded('pdo_mysql') ? array_filter([
+                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
+            ]) : [],
+        ],
+
+        'mariadb' => [
+            'driver' => 'mariadb',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '3306'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'unix_socket' => env('DB_SOCKET', ''),
+            'charset' => env('DB_CHARSET', 'utf8mb4'),
+            'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'strict' => true,
+            'engine' => null,
+            'options' => extension_loaded('pdo_mysql') ? array_filter([
+                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
+            ]) : [],
+        ],
+
+        'pgsql' => [
+            'driver' => 'pgsql',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '5432'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'charset' => env('DB_CHARSET', 'utf8'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'search_path' => 'public',
+            'sslmode' => 'prefer',
+        ],
+
+        'sqlsrv' => [
+            'driver' => 'sqlsrv',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', 'localhost'),
+            'port' => env('DB_PORT', '1433'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'charset' => env('DB_CHARSET', 'utf8'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            // 'encrypt' => env('DB_ENCRYPT', 'yes'),
+            // 'trust_server_certificate' => env('DB_TRUST_SERVER_CERTIFICATE', 'false'),
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Migration Repository Table
+    |--------------------------------------------------------------------------
+    |
+    | This table keeps track of all the migrations that have already run for
+    | your application. Using this information, we can determine which of
+    | the migrations on disk haven't actually been run on the database.
+    |
+    */
+
+    'migrations' => [
+        'table' => 'migrations',
+        'update_date_on_publish' => true,
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Redis Databases
+    |--------------------------------------------------------------------------
+    |
+    | Redis is an open source, fast, and advanced key-value store that also
+    | provides a richer body of commands than a typical key-value system
+    | such as Memcached. You may define your connection settings here.
+    |
+    */
+
+    'redis' => [
+
+        'client' => env('REDIS_CLIENT', 'phpredis'),
+
+        'options' => [
+            'cluster' => env('REDIS_CLUSTER', 'redis'),
+            'prefix' => env('REDIS_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_').'_database_'),
+        ],
+
+        'default' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => env('REDIS_DB', '0'),
+        ],
+
+        'cache' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => env('REDIS_CACHE_DB', '1'),
+        ],
+
+    ],
+
+];

demo/laravel/config/filesystems.php

@@ -0,0 +1,76 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Filesystem Disk
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify the default filesystem disk that should be used
+    | by the framework. The "local" disk, as well as a variety of cloud
+    | based disks are available to your application for file storage.
+    |
+    */
+
+    'default' => env('FILESYSTEM_DISK', 'local'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Filesystem Disks
+    |--------------------------------------------------------------------------
+    |
+    | Below you may configure as many filesystem disks as necessary, and you
+    | may even configure multiple disks for the same driver. Examples for
+    | most supported storage drivers are configured here for reference.
+    |
+    | Supported Drivers: "local", "ftp", "sftp", "s3"
+    |
+    */
+
+    'disks' => [
+
+        'local' => [
+            'driver' => 'local',
+            'root' => storage_path('app'),
+            'throw' => false,
+        ],
+
+        'public' => [
+            'driver' => 'local',
+            'root' => storage_path('app/public'),
+            'url' => env('APP_URL').'/storage',
+            'visibility' => 'public',
+            'throw' => false,
+        ],
+
+        's3' => [
+            'driver' => 's3',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'region' => env('AWS_DEFAULT_REGION'),
+            'bucket' => env('AWS_BUCKET'),
+            'url' => env('AWS_URL'),
+            'endpoint' => env('AWS_ENDPOINT'),
+            'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
+            'throw' => false,
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Symbolic Links
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure the symbolic links that will be created when the
+    | `storage:link` Artisan command is executed. The array keys should be
+    | the locations of the links and the values should be their targets.
+    |
+    */
+
+    'links' => [
+        public_path('storage') => storage_path('app/public'),
+    ],
+
+];

demo/laravel/config/flasher.php

@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+use Flasher\Prime\Configuration;
+
+/*
+ * Default PHPFlasher configuration for Laravel.
+ *
+ * This configuration file defines the default settings for PHPFlasher when
+ * used within a Laravel application. It uses the Configuration class from
+ * the core PHPFlasher library to establish type-safe configuration.
+ *
+ * @return array<string, mixed> PHPFlasher configuration
+ */
+return Configuration::from([
+    // Default notification library (e.g., 'flasher', 'toastr', 'noty', 'notyf', 'sweetalert')
+    'default' => 'flasher',
+
+    // Path to the main PHPFlasher JavaScript file
+    'main_script' => '/vendor/flasher/flasher.min.js',
+
+    // List of CSS files to style your notifications
+    'styles' => [
+        '/vendor/flasher/flasher.min.css',
+    ],
+
+    // Set global options for all notifications (optional)
+    // 'options' => [
+    //     'timeout' => 5000, // Time in milliseconds before the notification disappears
+    //     'position' => 'top-right', // Where the notification appears on the screen
+    // ],
+
+    // Automatically inject JavaScript and CSS assets into your HTML pages
+    'inject_assets' => true,
+
+    // Enable message translation using Laravel's translation service
+    'translate' => true,
+
+    // URL patterns to exclude from asset injection and flash_bag conversion
+    'excluded_paths' => [],
+
+    // Map Laravel flash message keys to notification types
+    'flash_bag' => [
+        'success' => ['success'],
+        'error' => ['error', 'danger'],
+        'warning' => ['warning', 'alarm'],
+        'info' => ['info', 'notice', 'alert'],
+    ],
+
+    // Set criteria to filter which notifications are displayed (optional)
+    // 'filter' => [
+    //     'limit' => 5, // Maximum number of notifications to show at once
+    // ],
+
+    // Define notification presets to simplify notification creation (optional)
+    // 'presets' => [
+    //     'entity_saved' => [
+    //         'type' => 'success',
+    //         'title' => 'Entity saved',
+    //         'message' => 'Entity saved successfully',
+    //     ],
+    // ],
+]);

demo/laravel/config/logging.php

@@ -0,0 +1,132 @@
+<?php
+
+use Monolog\Handler\NullHandler;
+use Monolog\Handler\StreamHandler;
+use Monolog\Handler\SyslogUdpHandler;
+use Monolog\Processor\PsrLogMessageProcessor;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Log Channel
+    |--------------------------------------------------------------------------
+    |
+    | This option defines the default log channel that is utilized to write
+    | messages to your logs. The value provided here should match one of
+    | the channels present in the list of "channels" configured below.
+    |
+    */
+
+    'default' => env('LOG_CHANNEL', 'stack'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Deprecations Log Channel
+    |--------------------------------------------------------------------------
+    |
+    | This option controls the log channel that should be used to log warnings
+    | regarding deprecated PHP and library features. This allows you to get
+    | your application ready for upcoming major versions of dependencies.
+    |
+    */
+
+    'deprecations' => [
+        'channel' => env('LOG_DEPRECATIONS_CHANNEL', 'null'),
+        'trace' => env('LOG_DEPRECATIONS_TRACE', false),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Log Channels
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure the log channels for your application. Laravel
+    | utilizes the Monolog PHP logging library, which includes a variety
+    | of powerful log handlers and formatters that you're free to use.
+    |
+    | Available Drivers: "single", "daily", "slack", "syslog",
+    |                    "errorlog", "monolog", "custom", "stack"
+    |
+    */
+
+    'channels' => [
+
+        'stack' => [
+            'driver' => 'stack',
+            'channels' => explode(',', env('LOG_STACK', 'single')),
+            'ignore_exceptions' => false,
+        ],
+
+        'single' => [
+            'driver' => 'single',
+            'path' => storage_path('logs/laravel.log'),
+            'level' => env('LOG_LEVEL', 'debug'),
+            'replace_placeholders' => true,
+        ],
+
+        'daily' => [
+            'driver' => 'daily',
+            'path' => storage_path('logs/laravel.log'),
+            'level' => env('LOG_LEVEL', 'debug'),
+            'days' => env('LOG_DAILY_DAYS', 14),
+            'replace_placeholders' => true,
+        ],
+
+        'slack' => [
+            'driver' => 'slack',
+            'url' => env('LOG_SLACK_WEBHOOK_URL'),
+            'username' => env('LOG_SLACK_USERNAME', 'Laravel Log'),
+            'emoji' => env('LOG_SLACK_EMOJI', ':boom:'),
+            'level' => env('LOG_LEVEL', 'critical'),
+            'replace_placeholders' => true,
+        ],
+
+        'papertrail' => [
+            'driver' => 'monolog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'handler' => env('LOG_PAPERTRAIL_HANDLER', SyslogUdpHandler::class),
+            'handler_with' => [
+                'host' => env('PAPERTRAIL_URL'),
+                'port' => env('PAPERTRAIL_PORT'),
+                'connectionString' => 'tls://'.env('PAPERTRAIL_URL').':'.env('PAPERTRAIL_PORT'),
+            ],
+            'processors' => [PsrLogMessageProcessor::class],
+        ],
+
+        'stderr' => [
+            'driver' => 'monolog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'handler' => StreamHandler::class,
+            'formatter' => env('LOG_STDERR_FORMATTER'),
+            'with' => [
+                'stream' => 'php://stderr',
+            ],
+            'processors' => [PsrLogMessageProcessor::class],
+        ],
+
+        'syslog' => [
+            'driver' => 'syslog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'facility' => env('LOG_SYSLOG_FACILITY', LOG_USER),
+            'replace_placeholders' => true,
+        ],
+
+        'errorlog' => [
+            'driver' => 'errorlog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'replace_placeholders' => true,
+        ],
+
+        'null' => [
+            'driver' => 'monolog',
+            'handler' => NullHandler::class,
+        ],
+
+        'emergency' => [
+            'path' => storage_path('logs/laravel.log'),
+        ],
+
+    ],
+
+];

demo/laravel/config/mail.php

@@ -0,0 +1,103 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Mailer
+    |--------------------------------------------------------------------------
+    |
+    | This option controls the default mailer that is used to send all email
+    | messages unless another mailer is explicitly specified when sending
+    | the message. All additional mailers can be configured within the
+    | "mailers" array. Examples of each type of mailer are provided.
+    |
+    */
+
+    'default' => env('MAIL_MAILER', 'log'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Mailer Configurations
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure all of the mailers used by your application plus
+    | their respective settings. Several examples have been configured for
+    | you and you are free to add your own as your application requires.
+    |
+    | Laravel supports a variety of mail "transport" drivers that can be used
+    | when delivering an email. You may specify which one you're using for
+    | your mailers below. You may also add additional mailers if needed.
+    |
+    | Supported: "smtp", "sendmail", "mailgun", "ses", "ses-v2",
+    |            "postmark", "log", "array", "failover", "roundrobin"
+    |
+    */
+
+    'mailers' => [
+
+        'smtp' => [
+            'transport' => 'smtp',
+            'url' => env('MAIL_URL'),
+            'host' => env('MAIL_HOST', '127.0.0.1'),
+            'port' => env('MAIL_PORT', 2525),
+            'encryption' => env('MAIL_ENCRYPTION', 'tls'),
+            'username' => env('MAIL_USERNAME'),
+            'password' => env('MAIL_PASSWORD'),
+            'timeout' => null,
+            'local_domain' => env('MAIL_EHLO_DOMAIN'),
+        ],
+
+        'ses' => [
+            'transport' => 'ses',
+        ],
+
+        'postmark' => [
+            'transport' => 'postmark',
+            // 'message_stream_id' => env('POSTMARK_MESSAGE_STREAM_ID'),
+            // 'client' => [
+            //     'timeout' => 5,
+            // ],
+        ],
+
+        'sendmail' => [
+            'transport' => 'sendmail',
+            'path' => env('MAIL_SENDMAIL_PATH', '/usr/sbin/sendmail -bs -i'),
+        ],
+
+        'log' => [
+            'transport' => 'log',
+            'channel' => env('MAIL_LOG_CHANNEL'),
+        ],
+
+        'array' => [
+            'transport' => 'array',
+        ],
+
+        'failover' => [
+            'transport' => 'failover',
+            'mailers' => [
+                'smtp',
+                'log',
+            ],
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Global "From" Address
+    |--------------------------------------------------------------------------
+    |
+    | You may wish for all emails sent by your application to be sent from
+    | the same address. Here you may specify a name and address that is
+    | used globally for all emails that are sent by your application.
+    |
+    */
+
+    'from' => [
+        'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
+        'name' => env('MAIL_FROM_NAME', 'Example'),
+    ],
+
+];

demo/laravel/config/queue.php

@@ -0,0 +1,112 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Queue Connection Name
+    |--------------------------------------------------------------------------
+    |
+    | Laravel's queue supports a variety of backends via a single, unified
+    | API, giving you convenient access to each backend using identical
+    | syntax for each. The default queue connection is defined below.
+    |
+    */
+
+    'default' => env('QUEUE_CONNECTION', 'database'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Queue Connections
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure the connection options for every queue backend
+    | used by your application. An example configuration is provided for
+    | each backend supported by Laravel. You're also free to add more.
+    |
+    | Drivers: "sync", "database", "beanstalkd", "sqs", "redis", "null"
+    |
+    */
+
+    'connections' => [
+
+        'sync' => [
+            'driver' => 'sync',
+        ],
+
+        'database' => [
+            'driver' => 'database',
+            'connection' => env('DB_QUEUE_CONNECTION'),
+            'table' => env('DB_QUEUE_TABLE', 'jobs'),
+            'queue' => env('DB_QUEUE', 'default'),
+            'retry_after' => (int) env('DB_QUEUE_RETRY_AFTER', 90),
+            'after_commit' => false,
+        ],
+
+        'beanstalkd' => [
+            'driver' => 'beanstalkd',
+            'host' => env('BEANSTALKD_QUEUE_HOST', 'localhost'),
+            'queue' => env('BEANSTALKD_QUEUE', 'default'),
+            'retry_after' => (int) env('BEANSTALKD_QUEUE_RETRY_AFTER', 90),
+            'block_for' => 0,
+            'after_commit' => false,
+        ],
+
+        'sqs' => [
+            'driver' => 'sqs',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'),
+            'queue' => env('SQS_QUEUE', 'default'),
+            'suffix' => env('SQS_SUFFIX'),
+            'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+            'after_commit' => false,
+        ],
+
+        'redis' => [
+            'driver' => 'redis',
+            'connection' => env('REDIS_QUEUE_CONNECTION', 'default'),
+            'queue' => env('REDIS_QUEUE', 'default'),
+            'retry_after' => (int) env('REDIS_QUEUE_RETRY_AFTER', 90),
+            'block_for' => null,
+            'after_commit' => false,
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Job Batching
+    |--------------------------------------------------------------------------
+    |
+    | The following options configure the database and table that store job
+    | batching information. These options can be updated to any database
+    | connection and table which has been defined by your application.
+    |
+    */
+
+    'batching' => [
+        'database' => env('DB_CONNECTION', 'sqlite'),
+        'table' => 'job_batches',
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Failed Queue Jobs
+    |--------------------------------------------------------------------------
+    |
+    | These options configure the behavior of failed queue job logging so you
+    | can control how and where failed jobs are stored. Laravel ships with
+    | support for storing failed jobs in a simple file or in a database.
+    |
+    | Supported drivers: "database-uuids", "dynamodb", "file", "null"
+    |
+    */
+
+    'failed' => [
+        'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'),
+        'database' => env('DB_CONNECTION', 'sqlite'),
+        'table' => 'failed_jobs',
+    ],
+
+];

demo/laravel/config/services.php

@@ -0,0 +1,34 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Third Party Services
+    |--------------------------------------------------------------------------
+    |
+    | This file is for storing the credentials for third party services such
+    | as Mailgun, Postmark, AWS and more. This file provides the de facto
+    | location for this type of information, allowing packages to have
+    | a conventional file to locate the various service credentials.
+    |
+    */
+
+    'postmark' => [
+        'token' => env('POSTMARK_TOKEN'),
+    ],
+
+    'ses' => [
+        'key' => env('AWS_ACCESS_KEY_ID'),
+        'secret' => env('AWS_SECRET_ACCESS_KEY'),
+        'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+    ],
+
+    'slack' => [
+        'notifications' => [
+            'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'),
+            'channel' => env('SLACK_BOT_USER_DEFAULT_CHANNEL'),
+        ],
+    ],
+
+];

demo/laravel/config/session.php

@@ -0,0 +1,231 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Session Driver
+    |--------------------------------------------------------------------------
+    |
+    | This option determines the default session driver that is utilized for
+    | incoming requests. Laravel supports a variety of storage options to
+    | persist session data. Database storage is a great default choice.
+    |
+    | Supported: "file", "cookie", "database", "apc",
+    |            "memcached", "redis", "dynamodb", "array"
+    |
+    */
+
+    'driver' => env('SESSION_DRIVER', 'database'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Lifetime
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify the number of minutes that you wish the session
+    | to be allowed to remain idle before it expires. If you want them
+    | to expire immediately when the browser is closed then you may
+    | indicate that via the expire_on_close configuration option.
+    |
+    */
+
+    'lifetime' => env('SESSION_LIFETIME', 120),
+
+    'expire_on_close' => env('SESSION_EXPIRE_ON_CLOSE', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Encryption
+    |--------------------------------------------------------------------------
+    |
+    | This option allows you to easily specify that all of your session data
+    | should be encrypted before it's stored. All encryption is performed
+    | automatically by Laravel and you may use the session like normal.
+    |
+    */
+
+    'encrypt' => env('SESSION_ENCRYPT', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Serialization
+    |--------------------------------------------------------------------------
+    |
+    | This option determines how session data is serialized before being stored.
+    | The "json" driver is more secure and performant but cannot serialize
+    | PHP objects. The "php" driver uses PHP's native serialization.
+    |
+    */
+
+    'serialization' => env('SESSION_SERIALIZATION', 'json'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session File Location
+    |--------------------------------------------------------------------------
+    |
+    | When utilizing the "file" session driver, the session files are placed
+    | on disk. The default storage location is defined here; however, you
+    | are free to provide another location where they should be stored.
+    |
+    */
+
+    'files' => storage_path('framework/sessions'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Database Connection
+    |--------------------------------------------------------------------------
+    |
+    | When using the "database" or "redis" session drivers, you may specify a
+    | connection that should be used to manage these sessions. This should
+    | correspond to a connection in your database configuration options.
+    |
+    */
+
+    'connection' => env('SESSION_CONNECTION'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Database Table
+    |--------------------------------------------------------------------------
+    |
+    | When using the "database" session driver, you may specify the table to
+    | be used to store sessions. Of course, a sensible default is defined
+    | for you; however, you're welcome to change this to another table.
+    |
+    */
+
+    'table' => env('SESSION_TABLE', 'sessions'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cache Store
+    |--------------------------------------------------------------------------
+    |
+    | When using one of the framework's cache driven session backends, you may
+    | define the cache store which should be used to store the session data
+    | between requests. This must match one of your defined cache stores.
+    |
+    | Affects: "apc", "dynamodb", "memcached", "redis"
+    |
+    */
+
+    'store' => env('SESSION_STORE'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Sweeping Lottery
+    |--------------------------------------------------------------------------
+    |
+    | Some session drivers must manually sweep their storage location to get
+    | rid of old sessions from storage. Here are the chances that it will
+    | happen on a given request. By default, the odds are 2 out of 100.
+    |
+    */
+
+    'lottery' => [2, 100],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cookie Name
+    |--------------------------------------------------------------------------
+    |
+    | Here you may change the name of the session cookie that is created by
+    | the framework. Typically, you should not need to change this value
+    | since doing so does not grant a meaningful security improvement.
+    |
+    |
+    */
+
+    'cookie' => env(
+        'SESSION_COOKIE',
+        Str::slug(env('APP_NAME', 'laravel'), '_').'_session'
+    ),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cookie Path
+    |--------------------------------------------------------------------------
+    |
+    | The session cookie path determines the path for which the cookie will
+    | be regarded as available. Typically, this will be the root path of
+    | your application, but you're free to change this when necessary.
+    |
+    */
+
+    'path' => env('SESSION_PATH', '/'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cookie Domain
+    |--------------------------------------------------------------------------
+    |
+    | This value determines the domain and subdomains the session cookie is
+    | available to. By default, the cookie will be available to the root
+    | domain and all subdomains. Typically, this shouldn't be changed.
+    |
+    */
+
+    'domain' => env('SESSION_DOMAIN'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | HTTPS Only Cookies
+    |--------------------------------------------------------------------------
+    |
+    | By setting this option to true, session cookies will only be sent back
+    | to the server if the browser has a HTTPS connection. This will keep
+    | the cookie from being sent to you when it can't be done securely.
+    |
+    */
+
+    'secure' => env('SESSION_SECURE_COOKIE'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | HTTP Access Only
+    |--------------------------------------------------------------------------
+    |
+    | Setting this value to true will prevent JavaScript from accessing the
+    | value of the cookie and the cookie will only be accessible through
+    | the HTTP protocol. It's unlikely you should disable this option.
+    |
+    */
+
+    'http_only' => env('SESSION_HTTP_ONLY', true),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Same-Site Cookies
+    |--------------------------------------------------------------------------
+    |
+    | This option determines how your cookies behave when cross-site requests
+    | take place, and can be used to mitigate CSRF attacks. By default, we
+    | will set this value to "lax" to permit secure cross-site requests.
+    |
+    | See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value
+    |
+    | Supported: "lax", "strict", "none", null
+    |
+    */
+
+    'same_site' => env('SESSION_SAME_SITE', 'lax'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Partitioned Cookies
+    |--------------------------------------------------------------------------
+    |
+    | Setting this value to true will tie the cookie to the top-level site for
+    | a cross-site context. Partitioned cookies are accepted by the browser
+    | when flagged "secure" and the Same-Site attribute is set to "none".
+    |
+    */
+
+    'partitioned' => env('SESSION_PARTITIONED_COOKIE', false),
+
+];

demo/laravel/database/.gitignore

@@ -0,0 +1 @@
+*.sqlite*

demo/laravel/database/factories/UserFactory.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Database\Factories;
+
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Str;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\User>
+ */
+class UserFactory extends Factory
+{
+    /**
+     * The current password being used by the factory.
+     */
+    protected static ?string $password;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'name' => fake()->name(),
+            'email' => fake()->unique()->safeEmail(),
+            'email_verified_at' => now(),
+            'password' => static::$password ??= Hash::make('password'),
+            'remember_token' => Str::random(10),
+        ];
+    }
+
+    /**
+     * Indicate that the model's email address should be unverified.
+     */
+    public function unverified(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'email_verified_at' => null,
+        ]);
+    }
+}

demo/laravel/database/migrations/0001_01_01_000000_create_users_table.php

@@ -0,0 +1,49 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('users', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('email')->unique();
+            $table->timestamp('email_verified_at')->nullable();
+            $table->string('password');
+            $table->rememberToken();
+            $table->timestamps();
+        });
+
+        Schema::create('password_reset_tokens', function (Blueprint $table) {
+            $table->string('email')->primary();
+            $table->string('token');
+            $table->timestamp('created_at')->nullable();
+        });
+
+        Schema::create('sessions', function (Blueprint $table) {
+            $table->string('id')->primary();
+            $table->foreignId('user_id')->nullable()->index();
+            $table->string('ip_address', 45)->nullable();
+            $table->text('user_agent')->nullable();
+            $table->longText('payload');
+            $table->integer('last_activity')->index();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('users');
+        Schema::dropIfExists('password_reset_tokens');
+        Schema::dropIfExists('sessions');
+    }
+};

demo/laravel/database/migrations/0001_01_01_000001_create_cache_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('cache', function (Blueprint $table) {
+            $table->string('key')->primary();
+            $table->mediumText('value');
+            $table->integer('expiration');
+        });
+
+        Schema::create('cache_locks', function (Blueprint $table) {
+            $table->string('key')->primary();
+            $table->string('owner');
+            $table->integer('expiration');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('cache');
+        Schema::dropIfExists('cache_locks');
+    }
+};

demo/laravel/database/migrations/0001_01_01_000002_create_jobs_table.php

@@ -0,0 +1,57 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('jobs', function (Blueprint $table) {
+            $table->id();
+            $table->string('queue')->index();
+            $table->longText('payload');
+            $table->unsignedTinyInteger('attempts');
+            $table->unsignedInteger('reserved_at')->nullable();
+            $table->unsignedInteger('available_at');
+            $table->unsignedInteger('created_at');
+        });
+
+        Schema::create('job_batches', function (Blueprint $table) {
+            $table->string('id')->primary();
+            $table->string('name');
+            $table->integer('total_jobs');
+            $table->integer('pending_jobs');
+            $table->integer('failed_jobs');
+            $table->longText('failed_job_ids');
+            $table->mediumText('options')->nullable();
+            $table->integer('cancelled_at')->nullable();
+            $table->integer('created_at');
+            $table->integer('finished_at')->nullable();
+        });
+
+        Schema::create('failed_jobs', function (Blueprint $table) {
+            $table->id();
+            $table->string('uuid')->unique();
+            $table->text('connection');
+            $table->text('queue');
+            $table->longText('payload');
+            $table->longText('exception');
+            $table->timestamp('failed_at')->useCurrent();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('jobs');
+        Schema::dropIfExists('job_batches');
+        Schema::dropIfExists('failed_jobs');
+    }
+};

demo/laravel/database/seeders/DatabaseSeeder.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\User;
+// use Illuminate\Database\Console\Seeds\WithoutModelEvents;
+use Illuminate\Database\Seeder;
+
+class DatabaseSeeder extends Seeder
+{
+    /**
+     * Seed the application's database.
+     */
+    public function run(): void
+    {
+        // User::factory(10)->create();
+
+        User::factory()->create([
+            'name' => 'Test User',
+            'email' => 'test@example.com',
+        ]);
+    }
+}

demo/laravel/package.json

@@ -0,0 +1,13 @@
+{
+    "private": true,
+    "type": "module",
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build"
+    },
+    "devDependencies": {
+        "axios": "^1.6.4",
+        "laravel-vite-plugin": "^1.0",
+        "vite": "^5.0"
+    }
+}

demo/laravel/phpstan.neon.dist

@@ -0,0 +1,7 @@
+includes:
+    - vendor/larastan/larastan/extension.neon
+
+parameters:
+    level: 9
+    paths:
+        - routes/

demo/laravel/public/.htaccess

@@ -0,0 +1,21 @@
+<IfModule mod_rewrite.c>
+    <IfModule mod_negotiation.c>
+        Options -MultiViews -Indexes
+    </IfModule>
+
+    RewriteEngine On
+
+    # Handle Authorization Header
+    RewriteCond %{HTTP:Authorization} .
+    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
+
+    # Redirect Trailing Slashes If Not A Folder...
+    RewriteCond %{REQUEST_FILENAME} !-d
+    RewriteCond %{REQUEST_URI} (.+)/$
+    RewriteRule ^ %1 [L,R=301]
+
+    # Send Requests To Front Controller...
+    RewriteCond %{REQUEST_FILENAME} !-d
+    RewriteCond %{REQUEST_FILENAME} !-f
+    RewriteRule ^ index.php [L]
+</IfModule>

demo/laravel/public/index.php

@@ -0,0 +1,17 @@
+<?php
+
+use Illuminate\Http\Request;
+
+define('LARAVEL_START', microtime(true));
+
+// Determine if the application is in maintenance mode...
+if (file_exists($maintenance = __DIR__.'/../storage/framework/maintenance.php')) {
+    require $maintenance;
+}
+
+// Register the Composer autoloader...
+require __DIR__.'/../vendor/autoload.php';
+
+// Bootstrap Laravel and handle the request...
+(require_once __DIR__.'/../bootstrap/app.php')
+    ->handleRequest(Request::capture());

demo/laravel/public/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Disallow:

demo/laravel/resources/css/app.css

@@ -0,0 +1,4 @@
+/* PHPFlasher Laravel Demo - Custom Styles */
+
+/* Any custom styles can be added here */
+/* Note: Main styling is handled via Tailwind CSS v4 CDN in the layout */

demo/laravel/resources/js/app.js

@@ -0,0 +1,11 @@
+/**
+ * PHPFlasher Laravel Demo
+ *
+ * Main JavaScript entry point.
+ * Note: PHPFlasher and other libraries are loaded via CDN in the layout.
+ */
+
+import './bootstrap';
+
+// Custom demo functionality can be added here
+console.log('PHPFlasher Laravel Demo loaded');

demo/laravel/resources/js/bootstrap.js

@@ -0,0 +1,4 @@
+import axios from 'axios';
+window.axios = axios;
+
+window.axios.defaults.headers.common['X-Requested-With'] = 'XMLHttpRequest';

demo/laravel/resources/views/adapters.blade.php

@@ -0,0 +1,354 @@
+@extends('layouts.app')
+
+@section('title', 'Adapters')
+
+@section('content')
+<div class="mb-8">
+    <h1 class="section-title">Notification Adapters</h1>
+    <p class="section-subtitle">PHPFlasher supports multiple notification libraries. Choose your favorite!</p>
+</div>
+
+<div class="space-y-8">
+    {{-- Flasher (Default) --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-indigo-500 to-purple-500"></div>
+        <div class="card-body">
+            <div class="flex flex-col lg:flex-row lg:items-start lg:justify-between gap-6">
+                <div class="flex-1">
+                    <div class="flex items-center space-x-3 mb-4">
+                        <div class="p-3 bg-indigo-100 rounded-xl">
+                            <svg class="w-8 h-8 text-indigo-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z"></path>
+                            </svg>
+                        </div>
+                        <div>
+                            <h2 class="text-2xl font-bold text-gray-800">Flasher</h2>
+                            <p class="text-gray-500">Default adapter with 17+ themes</p>
+                        </div>
+                    </div>
+
+                    <p class="text-gray-600 mb-4">The default PHPFlasher adapter with beautiful built-in themes. No additional JavaScript libraries required.</p>
+
+                    <div class="flex flex-wrap gap-2 mb-6">
+                        <button onclick="showNotification({type: 'success', message: 'This is the default Flasher notification!', adapter: 'flasher'})"
+                                class="btn btn-success">Success</button>
+                        <button onclick="showNotification({type: 'error', message: 'Error notification with Flasher', adapter: 'flasher'})"
+                                class="btn btn-danger">Error</button>
+                        <button onclick="showNotification({type: 'warning', message: 'Warning notification with Flasher', adapter: 'flasher'})"
+                                class="btn btn-warning">Warning</button>
+                        <button onclick="showNotification({type: 'info', message: 'Info notification with Flasher', adapter: 'flasher'})"
+                                class="btn btn-info">Info</button>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Installation</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-bash">composer require php-flasher/flasher-laravel</code></pre>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Usage</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-php">flash()->success('Operation completed!');</code></pre>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    {{-- Toastr --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-sky-500 to-blue-500"></div>
+        <div class="card-body">
+            <div class="flex flex-col lg:flex-row lg:items-start lg:justify-between gap-6">
+                <div class="flex-1">
+                    <div class="flex items-center space-x-3 mb-4">
+                        <div class="p-3 bg-sky-100 rounded-xl">
+                            <svg class="w-8 h-8 text-sky-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9"></path>
+                            </svg>
+                        </div>
+                        <div>
+                            <h2 class="text-2xl font-bold text-gray-800">Toastr</h2>
+                            <p class="text-gray-500">Simple, elegant toast notifications</p>
+                        </div>
+                    </div>
+
+                    <p class="text-gray-600 mb-4">Classic toast notifications with smooth animations. One of the most popular notification libraries.</p>
+
+                    <div class="flex flex-wrap gap-2 mb-6">
+                        <button onclick="showNotification({type: 'success', message: 'Toastr success notification!', adapter: 'toastr'})"
+                                class="btn btn-success">Success</button>
+                        <button onclick="showNotification({type: 'error', message: 'Toastr error notification!', adapter: 'toastr'})"
+                                class="btn btn-danger">Error</button>
+                        <button onclick="showNotification({type: 'warning', message: 'Toastr warning notification!', adapter: 'toastr'})"
+                                class="btn btn-warning">Warning</button>
+                        <button onclick="showNotification({type: 'info', message: 'Toastr info notification!', adapter: 'toastr'})"
+                                class="btn btn-info">Info</button>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Installation</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-bash">composer require php-flasher/flasher-toastr-laravel</code></pre>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Usage</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-php">toastr()->success('Data saved successfully!');
+
+// With options
+toastr()
+    ->closeButton()
+    ->progressBar()
+    ->positionClass('toast-top-right')
+    ->success('Profile updated!');</code></pre>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    {{-- SweetAlert --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-pink-500 to-rose-500"></div>
+        <div class="card-body">
+            <div class="flex flex-col lg:flex-row lg:items-start lg:justify-between gap-6">
+                <div class="flex-1">
+                    <div class="flex items-center space-x-3 mb-4">
+                        <div class="p-3 bg-pink-100 rounded-xl">
+                            <svg class="w-8 h-8 text-pink-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4.318 6.318a4.5 4.5 0 000 6.364L12 20.364l7.682-7.682a4.5 4.5 0 00-6.364-6.364L12 7.636l-1.318-1.318a4.5 4.5 0 00-6.364 0z"></path>
+                            </svg>
+                        </div>
+                        <div>
+                            <h2 class="text-2xl font-bold text-gray-800">SweetAlert 2</h2>
+                            <p class="text-gray-500">Beautiful, responsive, customizable alerts</p>
+                        </div>
+                    </div>
+
+                    <p class="text-gray-600 mb-4">Feature-rich modal dialogs with confirmations, inputs, and beautiful animations. Perfect for important user interactions.</p>
+
+                    <div class="flex flex-wrap gap-2 mb-6">
+                        <button onclick="showNotification({type: 'success', message: 'SweetAlert success!', title: 'Success', adapter: 'sweetalert'})"
+                                class="btn btn-success">Success</button>
+                        <button onclick="showNotification({type: 'error', message: 'SweetAlert error message', title: 'Error', adapter: 'sweetalert'})"
+                                class="btn btn-danger">Error</button>
+                        <button onclick="showNotification({type: 'warning', message: 'Are you sure you want to proceed?', title: 'Warning', adapter: 'sweetalert', options: {showCancelButton: true}})"
+                                class="btn btn-warning">Confirm Dialog</button>
+                        <button onclick="showNotification({type: 'info', message: 'Here is some information', title: 'Info', adapter: 'sweetalert'})"
+                                class="btn btn-info">Info</button>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Installation</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-bash">composer require php-flasher/flasher-sweetalert-laravel</code></pre>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Usage</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-php">sweetalert()->success('Great job!', 'Success');
+
+// Confirmation dialog
+sweetalert()
+    ->showDenyButton()
+    ->showCancelButton()
+    ->confirmButtonText('Save')
+    ->denyButtonText("Don't save")
+    ->warning('Do you want to save the changes?');</code></pre>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    {{-- Noty --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-emerald-500 to-teal-500"></div>
+        <div class="card-body">
+            <div class="flex flex-col lg:flex-row lg:items-start lg:justify-between gap-6">
+                <div class="flex-1">
+                    <div class="flex items-center space-x-3 mb-4">
+                        <div class="p-3 bg-emerald-100 rounded-xl">
+                            <svg class="w-8 h-8 text-emerald-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"></path>
+                            </svg>
+                        </div>
+                        <div>
+                            <h2 class="text-2xl font-bold text-gray-800">Noty</h2>
+                            <p class="text-gray-500">Dependency-free notification library</p>
+                        </div>
+                    </div>
+
+                    <p class="text-gray-600 mb-4">A flexible, dependency-free notification library with multiple layouts and themes.</p>
+
+                    <div class="flex flex-wrap gap-2 mb-6">
+                        <button onclick="showNotification({type: 'success', message: 'Noty success notification!', adapter: 'noty'})"
+                                class="btn btn-success">Success</button>
+                        <button onclick="showNotification({type: 'error', message: 'Noty error notification!', adapter: 'noty'})"
+                                class="btn btn-danger">Error</button>
+                        <button onclick="showNotification({type: 'warning', message: 'Noty warning notification!', adapter: 'noty'})"
+                                class="btn btn-warning">Warning</button>
+                        <button onclick="showNotification({type: 'info', message: 'Noty info notification!', adapter: 'noty'})"
+                                class="btn btn-info">Info</button>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Installation</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-bash">composer require php-flasher/flasher-noty-laravel</code></pre>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Usage</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-php">noty()->success('Data saved!');
+
+// With layout options
+noty()
+    ->layout('topCenter')
+    ->timeout(3000)
+    ->progressBar()
+    ->info('Processing your request...');</code></pre>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    {{-- Notyf --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-amber-500 to-orange-500"></div>
+        <div class="card-body">
+            <div class="flex flex-col lg:flex-row lg:items-start lg:justify-between gap-6">
+                <div class="flex-1">
+                    <div class="flex items-center space-x-3 mb-4">
+                        <div class="p-3 bg-amber-100 rounded-xl">
+                            <svg class="w-8 h-8 text-amber-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 7h8m0 0v8m0-8l-8 8-4-4-6 6"></path>
+                            </svg>
+                        </div>
+                        <div>
+                            <h2 class="text-2xl font-bold text-gray-800">Notyf</h2>
+                            <p class="text-gray-500">Minimalist, responsive notifications</p>
+                        </div>
+                    </div>
+
+                    <p class="text-gray-600 mb-4">A minimalist JavaScript library for toast notifications. Tiny footprint with smooth animations.</p>
+
+                    <div class="flex flex-wrap gap-2 mb-6">
+                        <button onclick="showNotification({type: 'success', message: 'Notyf success notification!', adapter: 'notyf'})"
+                                class="btn btn-success">Success</button>
+                        <button onclick="showNotification({type: 'error', message: 'Notyf error notification!', adapter: 'notyf'})"
+                                class="btn btn-danger">Error</button>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Installation</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-bash">composer require php-flasher/flasher-notyf-laravel</code></pre>
+                    </div>
+
+                    <div class="code-block">
+                        <div class="code-header">
+                            <span>Usage</span>
+                        </div>
+                        <pre class="!m-0"><code class="language-php">notyf()->success('Minimal and clean!');
+
+// With options
+notyf()
+    ->position('x', 'right')
+    ->position('y', 'top')
+    ->dismissible(true)
+    ->ripple(true)
+    ->success('File uploaded successfully!');</code></pre>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+
+{{-- Comparison Table --}}
+<div class="card mt-8">
+    <div class="card-header">
+        <h2 class="text-xl font-bold text-gray-800">Adapter Comparison</h2>
+    </div>
+    <div class="card-body overflow-x-auto">
+        <table class="w-full text-left">
+            <thead>
+                <tr class="border-b border-gray-200">
+                    <th class="py-3 px-4 font-semibold text-gray-700">Feature</th>
+                    <th class="py-3 px-4 font-semibold text-gray-700">Flasher</th>
+                    <th class="py-3 px-4 font-semibold text-gray-700">Toastr</th>
+                    <th class="py-3 px-4 font-semibold text-gray-700">SweetAlert</th>
+                    <th class="py-3 px-4 font-semibold text-gray-700">Noty</th>
+                    <th class="py-3 px-4 font-semibold text-gray-700">Notyf</th>
+                </tr>
+            </thead>
+            <tbody class="text-gray-600">
+                <tr class="border-b border-gray-100">
+                    <td class="py-3 px-4">Toast Notifications</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                </tr>
+                <tr class="border-b border-gray-100">
+                    <td class="py-3 px-4">Modal Dialogs</td>
+                    <td class="py-3 px-4 text-gray-400">No</td>
+                    <td class="py-3 px-4 text-gray-400">No</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-gray-400">No</td>
+                    <td class="py-3 px-4 text-gray-400">No</td>
+                </tr>
+                <tr class="border-b border-gray-100">
+                    <td class="py-3 px-4">Confirmations</td>
+                    <td class="py-3 px-4 text-gray-400">No</td>
+                    <td class="py-3 px-4 text-gray-400">No</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-gray-400">No</td>
+                </tr>
+                <tr class="border-b border-gray-100">
+                    <td class="py-3 px-4">Progress Bar</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-emerald-600">Yes</td>
+                    <td class="py-3 px-4 text-gray-400">No</td>
+                </tr>
+                <tr class="border-b border-gray-100">
+                    <td class="py-3 px-4">Built-in Themes</td>
+                    <td class="py-3 px-4 text-emerald-600">17+</td>
+                    <td class="py-3 px-4 text-emerald-600">4</td>
+                    <td class="py-3 px-4 text-emerald-600">1</td>
+                    <td class="py-3 px-4 text-emerald-600">5</td>
+                    <td class="py-3 px-4 text-emerald-600">1</td>
+                </tr>
+                <tr>
+                    <td class="py-3 px-4">Dependencies</td>
+                    <td class="py-3 px-4">None</td>
+                    <td class="py-3 px-4">jQuery</td>
+                    <td class="py-3 px-4">None</td>
+                    <td class="py-3 px-4">None</td>
+                    <td class="py-3 px-4">None</td>
+                </tr>
+            </tbody>
+        </table>
+    </div>
+</div>
+@endsection

demo/laravel/resources/views/components/layouts/app.blade.php

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
+    <head>
+        <meta charset="utf-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+        <title>{{ $title ?? 'Page Title' }}</title>
+    </head>
+    <body>
+        <ul>
+            <li><a href="/">/</a></li>
+            <li><a href="/adapter/flasher">/adapter/flasher</a></li>
+            <li><a href="/adapter/noty">/adapter/noty</a></li>
+            <li><a href="/adapter/notyf">/adapter/notyf</a></li>
+            <li><a href="/adapter/sweetalert">/adapter/sweetalert</a></li>
+            <li><a href="/adapter/toastr">/adapter/toastr</a></li>
+            <li><a href="/livewire/counter">/adapter/livewire/counter</a></li>
+            <li><a href="/livewire/eventous">/adapter/livewire/eventous</a></li>
+        </ul>
+        {{ $slot }}
+    </body>
+</html>

demo/laravel/resources/views/dashboard.blade.php

@@ -0,0 +1,83 @@
+@extends('layouts.app')
+
+@section('title', 'PHPFlasher Laravel Demo')
+
+@section('content')
+<div class="max-w-7xl mx-auto">
+    <div class="bg-white rounded-xl shadow-md overflow-hidden">
+        <div class="p-8">
+            <div class="uppercase tracking-wide text-sm text-indigo-600 font-semibold">Laravel Demo</div>
+            <h2 class="mt-2 text-3xl font-extrabold tracking-tight text-gray-900">Welcome to PHPFlasher</h2>
+            <p class="mt-4 text-lg text-gray-500">
+                PHPFlasher is a powerful notification library for PHP applications.
+                This demo shows how to use PHPFlasher in a Laravel project.
+            </p>
+
+            <div class="mt-8 grid grid-cols-1 gap-6 md:grid-cols-2 lg:grid-cols-3">
+                <!-- Feature Cards -->
+                <div class="bg-indigo-50 p-6 rounded-lg">
+                    <div class="text-indigo-600 mb-2">
+                        <svg xmlns="http://www.w3.org/2000/svg" class="h-8 w-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z" />
+                        </svg>
+                    </div>
+                    <h3 class="font-bold text-lg mb-2">Easy Integration</h3>
+                    <p class="text-gray-600">Simple API to create notifications from anywhere in your Laravel application.</p>
+                </div>
+
+                <div class="bg-emerald-50 p-6 rounded-lg">
+                    <div class="text-emerald-600 mb-2">
+                        <svg xmlns="http://www.w3.org/2000/svg" class="h-8 w-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 21a4 4 0 01-4-4V5a2 2 0 012-2h4a2 2 0 012 2v12a4 4 0 01-4 4zm0 0h12a2 2 0 002-2v-4a2 2 0 00-2-2h-2.343M11 7.343l1.657-1.657a2 2 0 012.828 0l2.829 2.829a2 2 0 010 2.828l-8.486 8.485M7 17h.01" />
+                        </svg>
+                    </div>
+                    <h3 class="font-bold text-lg mb-2">Multiple Themes</h3>
+                    <p class="text-gray-600">Choose from 15+ beautiful themes or create your own custom themes.</p>
+                </div>
+
+                <div class="bg-amber-50 p-6 rounded-lg">
+                    <div class="text-amber-600 mb-2">
+                        <svg xmlns="http://www.w3.org/2000/svg" class="h-8 w-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 5a1 1 0 011-1h14a1 1 0 011 1v2a1 1 0 01-1 1H5a1 1 0 01-1-1V5zM4 13a1 1 0 011-1h6a1 1 0 011 1v6a1 1 0 01-1 1H5a1 1 0 01-1-1v-6zM16 13a1 1 0 011-1h2a1 1 0 011 1v6a1 1 0 01-1 1h-2a1 1 0 01-1-1v-6z" />
+                        </svg>
+                    </div>
+                    <h3 class="font-bold text-lg mb-2">Flexible Positioning</h3>
+                    <p class="text-gray-600">Display notifications at any corner or side of your screen.</p>
+                </div>
+            </div>
+
+            <div class="mt-10">
+                <h3 class="text-lg font-medium text-gray-900">Try It Now</h3>
+                <div class="mt-4 flex flex-wrap gap-2">
+                    <a href="{{ route('all.types') }}" class="btn-primary">
+                        Show All Notification Types
+                    </a>
+                    <a href="{{ route('themes') }}" class="btn-outline">
+                        Explore Themes
+                    </a>
+                </div>
+            </div>
+
+            <div class="mt-10">
+                <h3 class="text-lg font-medium text-gray-900">Code Example</h3>
+                <div class="mt-4 code-block">
+                    <div class="code-header">
+                        <span>Basic Usage</span>
+                    </div>
+<pre><code class="language-php">// Display a success notification
+flash()->success('Item created successfully!');
+
+// Display an error notification
+flash()->error('An error occurred!');
+
+// Display a warning notification
+flash()->warning('Warning: This action cannot be undone.');
+
+// Display an info notification
+flash()->info('The task is running in the background.');</code></pre>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+@endsection

demo/laravel/resources/views/examples.blade.php

@@ -0,0 +1,349 @@
+@extends('layouts.app')
+
+@section('title', 'Real-World Examples')
+
+@section('content')
+<div class="mb-8">
+    <h1 class="section-title">Real-World Examples</h1>
+    <p class="section-subtitle">See how PHPFlasher handles common application scenarios. Click to run each example.</p>
+</div>
+
+<div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+    {{-- User Registration --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-emerald-500 to-green-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-emerald-100 rounded-xl">
+                    <svg class="w-6 h-6 text-emerald-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M18 9v3m0 0v3m0-3h3m-3 0h-3m-2-5a4 4 0 11-8 0 4 4 0 018 0zM3 20a6 6 0 0112 0v1H3v-1z"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">User Registration</h3>
+                    <p class="text-sm text-gray-500">Account creation flow</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Simulates a successful user registration with welcome message and email verification notice.</p>
+
+            <button onclick="runExample('registration')" class="btn btn-success w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">flash()->success('Welcome! Your account has been created.');
+flash()->info('Please check your email to verify your account.');</code></pre>
+            </div>
+        </div>
+    </div>
+
+    {{-- Login Flow --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-rose-500 to-red-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-rose-100 rounded-xl">
+                    <svg class="w-6 h-6 text-rose-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 15v2m-6 4h12a2 2 0 002-2v-6a2 2 0 00-2-2H6a2 2 0 00-2 2v6a2 2 0 002 2zm10-10V7a4 4 0 00-8 0v4h8z"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">Login Failed</h3>
+                    <p class="text-sm text-gray-500">Authentication error</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Shows how to display login failure messages with helpful guidance.</p>
+
+            <button onclick="runExample('login_failed')" class="btn btn-danger w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">flash()->error('Invalid email or password.');
+flash()->info('Forgot your password? Click here to reset.');</code></pre>
+            </div>
+        </div>
+    </div>
+
+    {{-- Form Validation --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-amber-500 to-yellow-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-amber-100 rounded-xl">
+                    <svg class="w-6 h-6 text-amber-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">Form Validation</h3>
+                    <p class="text-sm text-gray-500">Multiple field errors</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Demonstrates displaying multiple validation errors from a form submission.</p>
+
+            <button onclick="runExample('validation')" class="btn btn-warning w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">flash()->error('The email field is required.');
+flash()->error('Password must be at least 8 characters.');
+flash()->error('Please accept the terms and conditions.');</code></pre>
+            </div>
+        </div>
+    </div>
+
+    {{-- Shopping Cart --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-indigo-500 to-purple-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-indigo-100 rounded-xl">
+                    <svg class="w-6 h-6 text-indigo-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 3h2l.4 2M7 13h10l4-8H5.4M7 13L5.4 5M7 13l-2.293 2.293c-.63.63-.184 1.707.707 1.707H17m0 0a2 2 0 100 4 2 2 0 000-4zm-8 2a2 2 0 11-4 0 2 2 0 014 0z"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">Shopping Cart</h3>
+                    <p class="text-sm text-gray-500">E-commerce interactions</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Shows notifications for adding items to cart with stock warnings and promotions.</p>
+
+            <button onclick="runExample('shopping_cart')" class="btn btn-primary w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">flash()->success('iPhone 15 Pro added to cart!');
+flash()->warning('Only 2 items left in stock!');
+flash()->info('Add $20 more for free shipping!');</code></pre>
+            </div>
+        </div>
+    </div>
+
+    {{-- File Upload --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-sky-500 to-cyan-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-sky-100 rounded-xl">
+                    <svg class="w-6 h-6 text-sky-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">File Upload</h3>
+                    <p class="text-sm text-gray-500">Upload progress and status</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Demonstrates file upload progress with success and additional info.</p>
+
+            <button onclick="runExample('file_upload')" class="btn btn-info w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">flash()->success('document.pdf uploaded successfully!');
+flash()->info('File size: 2.4 MB');</code></pre>
+            </div>
+        </div>
+    </div>
+
+    {{-- Settings Saved --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-teal-500 to-green-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-teal-100 rounded-xl">
+                    <svg class="w-6 h-6 text-teal-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z"></path>
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">Settings Saved</h3>
+                    <p class="text-sm text-gray-500">Preferences updated</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Shows settings save confirmation with additional context.</p>
+
+            <button onclick="runExample('settings')" class="btn btn-success w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">flash()->success('Settings saved successfully!');
+flash()->info('Some changes may require a page refresh.');</code></pre>
+            </div>
+        </div>
+    </div>
+
+    {{-- Payment Success --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-green-500 to-emerald-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-green-100 rounded-xl">
+                    <svg class="w-6 h-6 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 10h18M7 15h1m4 0h1m-7 4h12a3 3 0 003-3V8a3 3 0 00-3-3H6a3 3 0 00-3 3v8a3 3 0 003 3z"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">Payment Success</h3>
+                    <p class="text-sm text-gray-500">Transaction completed</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Payment confirmation with order details and receipt notification.</p>
+
+            <button onclick="runExample('payment_success')" class="btn btn-success w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">flash()->success('Payment of $149.99 confirmed!');
+flash()->info('Order #12345 - Receipt sent to your email.');</code></pre>
+            </div>
+        </div>
+    </div>
+
+    {{-- Payment Failed --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-red-500 to-rose-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-red-100 rounded-xl">
+                    <svg class="w-6 h-6 text-red-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">Payment Failed</h3>
+                    <p class="text-sm text-gray-500">Transaction declined</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Payment failure with helpful guidance for resolving the issue.</p>
+
+            <button onclick="runExample('payment_failed')" class="btn btn-danger w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">flash()->error('Payment declined by your bank.');
+flash()->warning('Please try a different payment method.');
+flash()->info('Your cart has been saved.');</code></pre>
+            </div>
+        </div>
+    </div>
+
+    {{-- Delete Confirmation --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-pink-500 to-rose-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-pink-100 rounded-xl">
+                    <svg class="w-6 h-6 text-pink-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">Delete Confirmation</h3>
+                    <p class="text-sm text-gray-500">SweetAlert dialog</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Uses SweetAlert for a confirmation dialog before deleting.</p>
+
+            <button onclick="runExample('delete_confirm')" class="btn btn-danger w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">sweetalert()
+    ->showCancelButton()
+    ->confirmButtonText('Yes, delete it!')
+    ->cancelButtonText('Cancel')
+    ->warning('Are you sure? This cannot be undone.');</code></pre>
+            </div>
+        </div>
+    </div>
+
+    {{-- Session Expiring --}}
+    <div class="card">
+        <div class="h-2 bg-gradient-to-r from-orange-500 to-amber-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-4">
+                <div class="p-3 bg-orange-100 rounded-xl">
+                    <svg class="w-6 h-6 text-orange-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z"></path>
+                    </svg>
+                </div>
+                <div>
+                    <h3 class="text-lg font-bold text-gray-800">Session Expiring</h3>
+                    <p class="text-sm text-gray-500">Timeout warning</p>
+                </div>
+            </div>
+
+            <p class="text-gray-600 mb-4">Alerts user when their session is about to expire.</p>
+
+            <button onclick="runExample('session_expiring')" class="btn btn-warning w-full mb-4">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                </svg>
+                Run Example
+            </button>
+
+            <div class="code-block">
+                <div class="code-header"><span>PHP</span></div>
+                <pre class="!m-0"><code class="language-php">flash()->warning('Your session will expire in 5 minutes.');
+flash()->info('Click anywhere to stay logged in.');</code></pre>
+            </div>
+        </div>
+    </div>
+</div>
+@endsection

demo/laravel/resources/views/form.blade.php

@@ -0,0 +1,67 @@
+@extends('layouts.app')
+
+@section('title', 'Form Example - PHPFlasher Laravel Demo')
+
+@section('content')
+<div class="max-w-4xl mx-auto">
+    <div class="bg-white rounded-xl shadow-md overflow-hidden">
+        <div class="p-8">
+            <h2 class="text-2xl font-bold text-gray-900 mb-6">Contact Form Example</h2>
+
+            <div class="mb-8">
+                <p class="text-gray-600">
+                    This example demonstrates how PHPFlasher can be used to display form validation errors and success messages.
+                </p>
+            </div>
+
+            <div class="code-block mb-8">
+                <div class="code-header">
+                    <span>Controller Code</span>
+                </div>
+<pre><code class="language-php">public function processForm(Request $request)
+{
+    $validator = Validator::make($request->all(), [
+        'name' => 'required|min:2|max:50',
+        'email' => 'required|email',
+        'subject' => 'required|min:5',
+        'message' => 'required|min:10',
+    ]);
+
+    if ($validator->fails()) {
+        flash()->error('Please fix the errors in the form!');
+        return redirect()->back()
+            ->withErrors($validator)
+            ->withInput();
+    }
+
+    // Success scenario
+    flash()
+        ->success('Your message has been sent successfully!')
+        ->option('timeout', 8000);
+
+    return redirect()->route('form.example');
+}</code></pre>
+            </div>
+
+            <form action="{{ route('form.process') }}" method="POST" class="space-y-6">
+                @csrf
+
+                <div>
+                    <label for="name" class="block text-sm font-medium text-gray-700">Name</label>
+                    <input type="text" name="name" id="name" value="{{ old('name') }}" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-indigo-500 focus:ring-indigo-500">
+                    @error('name')
+                        <p class="mt-1 text-sm text-red-600">{{ $message }}</p>
+                    @enderror
+                </div>
+
+                <div>
+                    <label for="email" class="block text-sm font-medium text-gray-700">Email</label>
+                    <input type="email" name="email" id="email" value="{{ old('email') }}" class="mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-indigo-500 focus:ring-indigo-500">
+                    @error('email')
+                        <p class="mt-1 text-sm text-red-600">{{ $message }}</p>
+                    @enderror
+                </div>
+
+                <div>
+                    <label for="subject" class="block text-sm font-medium text-gray-700">Subject</label>
+                    <input type="text" name="subject" id="subject" value="{{ old('subject

demo/laravel/resources/views/home.blade.php

@@ -0,0 +1,197 @@
+@extends('layouts.app')
+
+@section('title', 'Home')
+
+@section('content')
+{{-- Hero Section --}}
+<div class="text-center mb-12">
+    <h1 class="text-4xl md:text-5xl font-bold text-gray-900 mb-4">
+        Beautiful Flash Notifications
+    </h1>
+    <p class="text-xl text-gray-600 max-w-2xl mx-auto mb-8">
+        PHPFlasher makes it easy to add elegant notifications to your Laravel application.
+        Try the quick demos below!
+    </p>
+
+    {{-- Quick Demo Buttons --}}
+    <div class="flex flex-wrap justify-center gap-3 mb-8">
+        <button onclick="showNotification({type: 'success', message: 'Operation completed successfully!', title: 'Success'})"
+                class="btn btn-success">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"></path>
+            </svg>
+            Success
+        </button>
+        <button onclick="showNotification({type: 'error', message: 'Something went wrong. Please try again.', title: 'Error'})"
+                class="btn btn-danger">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"></path>
+            </svg>
+            Error
+        </button>
+        <button onclick="showNotification({type: 'warning', message: 'Please review your input before continuing.', title: 'Warning'})"
+                class="btn btn-warning">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"></path>
+            </svg>
+            Warning
+        </button>
+        <button onclick="showNotification({type: 'info', message: 'Here is some useful information for you.', title: 'Info'})"
+                class="btn btn-info">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"></path>
+            </svg>
+            Info
+        </button>
+    </div>
+</div>
+
+{{-- Features Grid --}}
+<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6 mb-12">
+    {{-- Feature 1: Types --}}
+    <a href="{{ route('types') }}" class="card group">
+        <div class="h-2 bg-gradient-to-r from-emerald-500 to-teal-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-3">
+                <div class="p-2 bg-emerald-100 rounded-lg group-hover:bg-emerald-200 transition-colors">
+                    <svg class="w-6 h-6 text-emerald-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 8h10M7 12h4m1 8l-4-4H5a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v8a2 2 0 01-2 2h-3l-4 4z"></path>
+                    </svg>
+                </div>
+                <h3 class="text-xl font-bold text-gray-800">Notification Types</h3>
+            </div>
+            <p class="text-gray-600">Success, error, warning, and info notifications for every use case.</p>
+        </div>
+    </a>
+
+    {{-- Feature 2: Themes --}}
+    <a href="{{ route('themes') }}" class="card group">
+        <div class="h-2 bg-gradient-to-r from-purple-500 to-pink-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-3">
+                <div class="p-2 bg-purple-100 rounded-lg group-hover:bg-purple-200 transition-colors">
+                    <svg class="w-6 h-6 text-purple-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 21a4 4 0 01-4-4V5a2 2 0 012-2h4a2 2 0 012 2v12a4 4 0 01-4 4zm0 0h12a2 2 0 002-2v-4a2 2 0 00-2-2h-2.343M11 7.343l1.657-1.657a2 2 0 012.828 0l2.829 2.829a2 2 0 010 2.828l-8.486 8.485M7 17h.01"></path>
+                    </svg>
+                </div>
+                <h3 class="text-xl font-bold text-gray-800">17+ Themes</h3>
+            </div>
+            <p class="text-gray-600">Material, iOS, Slack, Amazon, and many more beautiful themes.</p>
+        </div>
+    </a>
+
+    {{-- Feature 3: Adapters --}}
+    <a href="{{ route('adapters') }}" class="card group">
+        <div class="h-2 bg-gradient-to-r from-blue-500 to-cyan-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-3">
+                <div class="p-2 bg-blue-100 rounded-lg group-hover:bg-blue-200 transition-colors">
+                    <svg class="w-6 h-6 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 14v6m-3-3h6M6 10h2a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v2a2 2 0 002 2zm10 0h2a2 2 0 002-2V6a2 2 0 00-2-2h-2a2 2 0 00-2 2v2a2 2 0 002 2zM6 20h2a2 2 0 002-2v-2a2 2 0 00-2-2H6a2 2 0 00-2 2v2a2 2 0 002 2z"></path>
+                    </svg>
+                </div>
+                <h3 class="text-xl font-bold text-gray-800">Multiple Adapters</h3>
+            </div>
+            <p class="text-gray-600">Toastr, SweetAlert, Noty, and Notyf adapters included.</p>
+        </div>
+    </a>
+
+    {{-- Feature 4: Positions --}}
+    <a href="{{ route('positions') }}" class="card group">
+        <div class="h-2 bg-gradient-to-r from-amber-500 to-orange-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-3">
+                <div class="p-2 bg-amber-100 rounded-lg group-hover:bg-amber-200 transition-colors">
+                    <svg class="w-6 h-6 text-amber-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 5a1 1 0 011-1h14a1 1 0 011 1v2a1 1 0 01-1 1H5a1 1 0 01-1-1V5zM4 13a1 1 0 011-1h6a1 1 0 011 1v6a1 1 0 01-1 1H5a1 1 0 01-1-1v-6zM16 13a1 1 0 011-1h2a1 1 0 011 1v6a1 1 0 01-1 1h-2a1 1 0 01-1-1v-6z"></path>
+                    </svg>
+                </div>
+                <h3 class="text-xl font-bold text-gray-800">Flexible Positions</h3>
+            </div>
+            <p class="text-gray-600">Place notifications anywhere on the screen.</p>
+        </div>
+    </a>
+
+    {{-- Feature 5: Examples --}}
+    <a href="{{ route('examples') }}" class="card group">
+        <div class="h-2 bg-gradient-to-r from-rose-500 to-red-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-3">
+                <div class="p-2 bg-rose-100 rounded-lg group-hover:bg-rose-200 transition-colors">
+                    <svg class="w-6 h-6 text-rose-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10"></path>
+                    </svg>
+                </div>
+                <h3 class="text-xl font-bold text-gray-800">Real Examples</h3>
+            </div>
+            <p class="text-gray-600">User registration, shopping cart, payments, and more.</p>
+        </div>
+    </a>
+
+    {{-- Feature 6: Playground --}}
+    <a href="{{ route('playground') }}" class="card group">
+        <div class="h-2 bg-gradient-to-r from-indigo-500 to-violet-500"></div>
+        <div class="card-body">
+            <div class="flex items-center space-x-3 mb-3">
+                <div class="p-2 bg-indigo-100 rounded-lg group-hover:bg-indigo-200 transition-colors">
+                    <svg class="w-6 h-6 text-indigo-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 12a9 9 0 11-18 0 9 9 0 0118 0z"></path>
+                    </svg>
+                </div>
+                <h3 class="text-xl font-bold text-gray-800">Interactive Playground</h3>
+            </div>
+            <p class="text-gray-600">Build and customize notifications in real-time.</p>
+        </div>
+    </a>
+</div>
+
+{{-- Quick Start Code --}}
+<div class="card mb-12">
+    <div class="card-header">
+        <h2 class="text-xl font-bold text-gray-800">Quick Start</h2>
+    </div>
+    <div class="card-body">
+        <p class="text-gray-600 mb-4">Get started with PHPFlasher in seconds. Just install and use!</p>
+
+        <div class="code-block">
+            <div class="code-header">
+                <span>Installation</span>
+            </div>
+            <pre class="!m-0"><code class="language-bash">composer require php-flasher/flasher-laravel</code></pre>
+        </div>
+
+        <div class="code-block">
+            <div class="code-header">
+                <span>Usage</span>
+            </div>
+            <pre class="!m-0"><code class="language-php">// In your controller
+flash()->success('Profile updated successfully!');
+
+// With options
+flash()->success('Welcome back!', [
+    'position' => 'top-right',
+    'timeout' => 5000,
+]);
+
+// Using themes
+flash()->use('theme.material')->info('New feature available!');</code></pre>
+        </div>
+    </div>
+</div>
+
+{{-- CTA Section --}}
+<div class="bg-gradient-to-r from-indigo-600 to-purple-600 rounded-2xl p-8 text-center text-white">
+    <h2 class="text-2xl md:text-3xl font-bold mb-4">Ready to try PHPFlasher?</h2>
+    <p class="text-indigo-100 mb-6 max-w-xl mx-auto">
+        Explore the interactive playground to customize notifications and see the generated code.
+    </p>
+    <a href="{{ route('playground') }}" class="inline-flex items-center px-6 py-3 bg-white text-indigo-600 font-semibold rounded-lg hover:bg-indigo-50 transition-colors">
+        <svg class="w-5 h-5 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M14.752 11.168l-3.197-2.132A1 1 0 0010 9.87v4.263a1 1 0 001.555.832l3.197-2.132a1 1 0 000-1.664z"></path>
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 12a9 9 0 11-18 0 9 9 0 0118 0z"></path>
+        </svg>
+        Open Playground
+    </a>
+</div>
+@endsection