Add v2.5.0 release preparation tests and update CHANGELOG

Features:
- Hero section with animated gradient background
- Themes organized by category (Brand-Inspired, Gemstone, Minimal)
- Visual cards with gradient previews for each theme
- Interactive "Try All Themes" section with demo buttons
- Usage code examples for setting default or per-notification themes
- CTA linking to playground
- Added "All Themes" link to navigation menu

.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

@@ -0,0 +1,109 @@
+{
+    "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

.editorconfig

@@ -0,0 +1,22 @@
+; This file is for unifying the coding style for different editors and IDEs.
+; More information at http://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+indent_size = 4
+indent_style = space
+end_of_line = lf
+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 @@
-# These are supported funding model platforms
-
-patreon: yoeunes
-ko_fi: yoeunes
-custom: ['https://www.paypal.com/paypalme/yoeunes']
+github: 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,103 +1,233 @@
-name: Running tests
+name: qa
 
 on:
     push:
+        branches:
+            - main
+            - 2.x
     pull_request:
     schedule:
-        -   cron: '0 * * * *'
+        -   cron: '0 0 * * *' # Daily at midnight
 
 jobs:
-    test:
+    javascript-tests:
         runs-on: ubuntu-latest
-        strategy:
-            fail-fast: true
-            matrix:
-                symfony: [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.*]
-                include:
-                    -   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
-
-        name: S${{ matrix.symfony }} - P${{ matrix.php }}
+        name: JavaScript Tests
 
         steps:
-            -   name: Checkout code
-                uses: actions/checkout@v1
+            -   name: 📥 Checkout Code
+                uses: actions/checkout@v4
 
-            -   name: Cache dependencies
-                uses: actions/cache@v1
+            -   name: 🔧 Setup Node.js
+                uses: actions/setup-node@v4
                 with:
-                    path: ~/.composer/cache/files
-                    key: dependencies-symfony-${{ matrix.symfony }}-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
+                    node-version: '20.x'
+                    cache: 'npm'
 
-            -   name: Setup PHP
+            -   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:
+                php: [ 8.2 ]
+
+        name: 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: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick
                     coverage: none
 
-            -   name: Install dependencies
-                run: |
-                    composer require "symfony/symfony:${{ matrix.symfony }}" "phpunit/phpunit:${{ matrix.phpunit }}" --no-interaction --no-update
-                    composer config extra.symfony.require "${{ matrix.symfony }}"
-                    composer update --prefer-dist --no-interaction --no-suggest
+            -   name: 🚚 Cache Composer 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: Execute tests
-                run: vendor/bin/phpunit
+            -   name: 📦 Install Dependencies
+                run: |
+                    composer config --global allow-plugins true
+                    composer install --no-interaction --prefer-dist --optimize-autoloader
+
+            -   name: 🧹 Run PHP CS Fixer (Code Style)
+                run: vendor/bin/php-cs-fixer fix --dry-run --diff
+
+            -   name: 🔍 Run PHPStan (Static Analysis)
+                run: vendor/bin/phpstan analyse --no-progress
+
+            -   name: 🚀 Run PHPLint (Syntax Check)
+                run: vendor/bin/phplint
+
+    prime-test:
+        needs: static-analysis
+        runs-on: ubuntu-latest
+        strategy:
+            fail-fast: false
+            matrix:
+                include:
+                    - { php: 8.4, phpunit: 10.5.* }
+                    - { php: 8.3, phpunit: 10.5.* }
+                    - { php: 8.2, phpunit: 10.5.* }
+
+        name: 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 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@v4
+                with:
+                    path: ~/.composer/cache
+                    key: ${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
+                    restore-keys: ${{ matrix.php }}-composer
+
+            -   name: 📦 Install dependencies
+                run: |
+                    sed -i '/\"require\": {/,/},/d; /\"require-dev\": {/,/},/d' composer.json
+                    composer config --global allow-plugins true
+
+                    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,5 +1,27 @@
-.idea/
-vendor/
-composer.lock
-.phpunit.result.cache
-.phpcs-cache
+/.idea/
+/.DS_Store
+
+/vendor/
+/node_modules/
+
+/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

@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
+use PhpCsFixer\Runner\Parallel\ParallelConfigFactory;
+
+$finder = Finder::create()
+    ->in([
+        __DIR__.'/src',
+        __DIR__.'/tests',
+        __DIR__.'/phpstorm',
+    ])
+    ->append([__FILE__])
+;
+
+return (new Config())
+    ->setParallelConfig(ParallelConfigFactory::detect())
+    ->setRiskyAllowed(true)
+    ->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

.phpcs.xml.dist

@@ -1,625 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<ruleset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/squizlabs/PHP_CodeSniffer/master/phpcs.xsd"
->
-    <arg name="basepath" value="."/>
-    <arg name="extensions" value="php"/>
-    <arg name="parallel" value="80"/>
-    <arg name="cache" value=".phpcs-cache"/>
-    <arg name="colors"/>
-
-    <!-- Ignore warnings, show progress of the run and show sniff names -->
-    <arg value="nps"/>
-
-    <!-- Directories to be checked -->
-    <file>src</file>
-    <file>tests</file>
-
-    <!-- Import PSR-12 coding standard (base) -->
-    <rule ref="PSR12"/>
-
-    <!-- Force array element indentation with 4 spaces -->
-    <rule ref="Generic.Arrays.ArrayIndent"/>
-
-    <!-- Forbid `[...]` -->
-    <rule ref="Generic.Arrays.DisallowShortArraySyntax"/>
-
-    <!-- Forbid duplicate classes -->
-    <rule ref="Generic.Classes.DuplicateClassName"/>
-
-    <!-- Forbid empty statements -->
-    <rule ref="Generic.CodeAnalysis.EmptyStatement">
-        <!-- But allow empty catch -->
-        <exclude name="Generic.CodeAnalysis.EmptyStatement.DetectedCatch"/>
-    </rule>
-
-    <!-- Forbid final methods in final classes -->
-    <rule ref="Generic.CodeAnalysis.UnnecessaryFinalModifier"/>
-
-    <!-- Forbid useless empty method overrides -->
-    <rule ref="Generic.CodeAnalysis.UselessOverridingMethod"/>
-
-    <!-- Align corresponding assignment statement tokens -->
-    <rule ref="Generic.Formatting.MultipleStatementAlignment">
-        <properties>
-            <property name="error" value="true"/>
-        </properties>
-    </rule>
-
-    <!-- Force whitespace after a type cast -->
-    <rule ref="Generic.Formatting.SpaceAfterCast">
-        <properties>
-            <property name="spacing" value="0"/>
-        </properties>
-    </rule>
-
-    <!-- Force whitespace after `!` -->
-    <!-- <rule ref="Generic.Formatting.SpaceAfterNot"/> -->
-
-    <!-- Forbid PHP 4 constructors -->
-    <rule ref="Generic.NamingConventions.ConstructorName"/>
-
-    <!-- Forbid any content before opening tag -->
-    <rule ref="Generic.PHP.CharacterBeforePHPOpeningTag"/>
-
-    <!-- Forbid deprecated functions -->
-    <rule ref="Generic.PHP.DeprecatedFunctions"/>
-
-    <!-- Forbid alias functions, i.e. `sizeof()`, `delete()` -->
-    <rule ref="Generic.PHP.ForbiddenFunctions">
-        <properties>
-            <property name="forbiddenFunctions" type="array">
-                <element key="chop" value="rtrim"/>
-                <element key="close" value="closedir"/>
-                <element key="compact" value="null"/>
-                <element key="delete" value="unset"/>
-                <element key="doubleval" value="floatval"/>
-                <element key="extract" value="null"/>
-                <element key="fputs" value="fwrite"/>
-                <element key="ini_alter" value="ini_set"/>
-                <element key="is_double" value="is_float"/>
-                <element key="is_integer" value="is_int"/>
-                <element key="is_long" value="is_int"/>
-                <element key="is_null" value="null"/>
-                <element key="is_real" value="is_float"/>
-                <element key="is_writeable" value="is_writable"/>
-                <element key="join" value="implode"/>
-                <element key="key_exists" value="array_key_exists"/>
-                <element key="pos" value="current"/>
-                <element key="settype" value="null"/>
-                <element key="show_source" value="highlight_file"/>
-                <element key="sizeof" value="count"/>
-                <element key="strchr" value="strstr"/>
-                <element key="user_error" value="trigger_error"/>
-            </property>
-        </properties>
-    </rule>
-
-    <!-- Forbid useless inline string concatenation -->
-    <rule ref="Generic.Strings.UnnecessaryStringConcat">
-        <!-- But multiline is useful for readability -->
-        <properties>
-            <property name="allowMultiline" value="true"/>
-        </properties>
-    </rule>
-
-    <!-- Forbid backtick operator -->
-    <rule ref="Generic.PHP.BacktickOperator"/>
-
-    <!-- Force PHP 7 param and return types to be lowercased -->
-    <rule ref="Generic.PHP.LowerCaseType"/>
-
-    <!-- Forbid `php_sapi_name()` function -->
-    <rule ref="Generic.PHP.SAPIUsage"/>
-
-    <!-- Forbid comments starting with # -->
-    <rule ref="PEAR.Commenting.InlineComment"/>
-
-    <!-- Disallow else if in favor of elseif -->
-    <rule ref="PSR2.ControlStructures.ElseIfDeclaration.NotAllowed">
-        <type>error</type>
-    </rule>
-
-    <!-- Require that single line arrays have the correct spacing: no space around brackets and one space after comma -->
-    <rule ref="SlevomatCodingStandard.Arrays.SingleLineArrayWhitespace"/>
-
-    <!-- Require comma after last element in multi-line array -->
-    <rule ref="SlevomatCodingStandard.Arrays.TrailingArrayComma"/>
-
-    <!-- Require presence of constant visibility -->
-    <!-- <rule ref="SlevomatCodingStandard.Classes.ClassConstantVisibility">
-        <properties>
-            <property name="fixable" value="true"/>
-        </properties>
-    </rule> -->
-
-    <!-- Forbid LSB for constants (static::FOO) -->
-    <rule ref="SlevomatCodingStandard.Classes.DisallowLateStaticBindingForConstants"/>
-
-    <!-- Forbid more than one constant declared per statement -->
-    <rule ref="SlevomatCodingStandard.Classes.DisallowMultiConstantDefinition"/>
-
-    <!-- Forbid empty lines around type declarations -->
-    <rule ref="SlevomatCodingStandard.Classes.EmptyLinesAroundClassBraces">
-        <properties>
-            <property name="linesCountAfterOpeningBrace" value="0"/>
-            <property name="linesCountBeforeClosingBrace" value="0"/>
-        </properties>
-    </rule>
-
-    <!-- Require usage of ::class instead of __CLASS__, get_class(), get_class($this), get_called_class() and get_parent_class() -->
-    <!-- <rule ref="SlevomatCodingStandard.Classes.ModernClassNameReference"/> -->
-
-    <!-- Forbid uses of multiple traits separated by comma -->
-    <rule ref="SlevomatCodingStandard.Classes.TraitUseDeclaration"/>
-
-    <!-- Require no spaces before trait use, between trait uses and one space after trait uses -->
-    <rule ref="SlevomatCodingStandard.Classes.TraitUseSpacing">
-        <properties>
-            <property name="linesCountAfterLastUse" value="1"/>
-            <property name="linesCountAfterLastUseWhenLastInClass" value="0"/>
-            <property name="linesCountBeforeFirstUse" value="0"/>
-            <property name="linesCountBetweenUses" value="0"/>
-        </properties>
-    </rule>
-
-    <!-- Forbid dead code -->
-    <rule ref="SlevomatCodingStandard.Classes.UnusedPrivateElements"/>
-
-    <!-- Forbid useless annotations - Git and LICENCE file provide more accurate information -->
-    <rule ref="SlevomatCodingStandard.Commenting.ForbiddenAnnotations">
-        <properties>
-            <property name="forbiddenAnnotations" type="array">
-                <element value="@api"/>
-                <element value="@author"/>
-                <element value="@category"/>
-                <element value="@copyright"/>
-                <element value="@created"/>
-                <element value="@license"/>
-                <element value="@package"/>
-                <element value="@since"/>
-                <element value="@subpackage"/>
-                <element value="@version"/>
-            </property>
-        </properties>
-    </rule>
-
-    <!-- Forbid empty comments -->
-    <rule ref="SlevomatCodingStandard.Commenting.EmptyComment"/>
-
-    <!-- Forbid useless comments -->
-    <rule ref="SlevomatCodingStandard.Commenting.ForbiddenComments">
-        <properties>
-            <property name="forbiddenCommentPatterns" type="array">
-                <element value="~^(?:(?!private|protected|static)\S+ )?(?:con|de)structor\.\z~i"/>
-                <element value="~^Created by .+\.\z~i"/>
-                <element value="~^(User|Date|Time): \S+\z~i"/>
-                <element value="~^\S+ [gs]etter\.\z~i"/>
-                <element value="~^(Class|Interface|Trait) \S+\z~i"/>
-            </property>
-        </properties>
-    </rule>
-
-    <!-- Require specific order of phpDoc annotations with empty newline between specific groups -->
-    <rule ref="SlevomatCodingStandard.Commenting.DocCommentSpacing">
-        <properties>
-            <property name="linesCountBeforeFirstContent" value="0"/>
-            <property name="linesCountAfterLastContent" value="0"/>
-            <property name="linesCountBetweenDescriptionAndAnnotations" value="1"/>
-            <property name="linesCountBetweenAnnotationsGroups" value="1"/>
-            <property name="annotationsGroups" type="array">
-                <element value="
-                    @internal,
-                    @deprecated,
-                "/>
-                <element value="
-                    @link,
-                    @see,
-                    @uses,
-                "/>
-                <element value="@var"/>
-                <element value="@ORM\"/>
-                <element value="@param"/>
-                <element value="@return"/>
-                <element value="@throws"/>
-            </property>
-        </properties>
-    </rule>
-
-    <!-- Report invalid format of inline phpDocs with @var -->
-    <rule ref="SlevomatCodingStandard.Commenting.InlineDocCommentDeclaration"/>
-
-    <!-- Require comments with single line written as one-liners -->
-    <!-- <rule ref="SlevomatCodingStandard.Commenting.RequireOneLinePropertyDocComment"/> -->
-
-    <!-- Forbid assignments in conditions -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.AssignmentInCondition"/>
-
-    <!-- Require consistent spacing for block structures -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.BlockControlStructureSpacing">
-        <exclude name="SlevomatCodingStandard.ControlStructures.BlockControlStructureSpacing.IncorrectLinesCountBeforeControlStructure" />
-        <exclude name="SlevomatCodingStandard.ControlStructures.BlockControlStructureSpacing.IncorrectLinesCountBeforeFirstControlStructure" />
-        <properties>
-            <property name="tokensToCheck" type="array">
-                <element value="T_IF" />
-                <element value="T_DO" />
-                <element value="T_WHILE" />
-                <element value="T_FOR" />
-                <element value="T_FOREACH" />
-                <element value="T_SWITCH" />
-                <element value="T_TRY" />
-                <element value="T_DEFAULT" />
-            </property>
-        </properties>
-    </rule>
-
-    <!-- Forbid fancy yoda conditions -->
-    <!-- <rule ref="SlevomatCodingStandard.ControlStructures.DisallowYodaComparison"/> -->
-
-    <!-- Require usage of early exit -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.EarlyExit"/>
-
-    <!-- Require consistent spacing for jump statements -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.JumpStatementsSpacing">
-        <properties>
-            <property name="linesCountBeforeWhenFirstInCaseOrDefault" value="0"/>
-            <property name="linesCountAfterWhenLastInCaseOrDefault" value="1"/>
-            <property name="linesCountAfterWhenLastInLastCaseOrDefault" value="0"/>
-            <property name="tokensToCheck" type="array">
-                <element value="T_RETURN" />
-                <element value="T_THROW" />
-                <element value="T_YIELD" />
-                <element value="T_YIELD_FROM" />
-            </property>
-        </properties>
-    </rule>
-
-    <!-- Require language constructs without parentheses -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.LanguageConstructWithParentheses"/>
-
-    <!-- Require usage of null coalesce operator equal operator when possible -->
-    <!-- <rule ref="SlevomatCodingStandard.ControlStructures.RequireNullCoalesceEqualOperator"/> -->
-
-    <!-- Require usage of null coalesce operator when possible -->
-    <!-- <rule ref="SlevomatCodingStandard.ControlStructures.RequireNullCoalesceOperator"/> -->
-
-    <!-- Forbid usage of conditions when a simple return can be used -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.UselessIfConditionWithReturn"/>
-
-    <!-- Forbid usage of boolean-only ternary operator usage (e.g. $foo ? true : false) -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.UselessTernaryOperator"/>
-
-    <!-- Forbid useless unreachable catch blocks -->
-    <rule ref="SlevomatCodingStandard.Exceptions.DeadCatch"/>
-
-    <!-- Require using Throwable instead of Exception -->
-    <rule ref="SlevomatCodingStandard.Exceptions.ReferenceThrowableOnly"/>
-
-    <!-- Ensure Arrow Functions declaration format -->
-    <rule ref="SlevomatCodingStandard.Functions.ArrowFunctionDeclaration">
-        <properties>
-            <property name="spacesCountAfterKeyword" value="1"/>
-            <property name="spacesCountBeforeArrow" value="1"/>
-            <property name="spacesCountAfterArrow" value="1"/>
-        </properties>
-    </rule>
-
-    <!-- Require closures not referencing $this be static -->
-    <rule ref="SlevomatCodingStandard.Functions.StaticClosure"/>
-
-    <!-- Forbid unused variables passed to closures via `use` -->
-    <rule ref="SlevomatCodingStandard.Functions.UnusedInheritedVariablePassedToClosure"/>
-
-    <!-- Require presence of declare(strict_types=1) -->
-    <!-- <rule ref="SlevomatCodingStandard.TypeHints.DeclareStrictTypes">
-        <properties>
-            <property name="newlinesCountBetweenOpenTagAndDeclare" value="2"/>
-            <property name="spacesCountAroundEqualsSign" value="0"/>
-            <property name="newlinesCountAfterDeclare" value="2"/>
-        </properties>
-    </rule> -->
-
-    <!-- Require consistent spacing for block structures -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.BlockControlStructureSpacing"/>
-
-    <!-- Forbid unused use statements -->
-    <rule ref="SlevomatCodingStandard.Namespaces.UnusedUses">
-        <properties>
-            <property name="searchAnnotations" value="true"/>
-        </properties>
-    </rule>
-
-    <!-- Require use statements to be alphabetically sorted -->
-    <rule ref="SlevomatCodingStandard.Namespaces.AlphabeticallySortedUses"/>
-
-    <!-- Forbid fancy group uses -->
-    <rule ref="SlevomatCodingStandard.Namespaces.DisallowGroupUse"/>
-
-    <!-- Forbid multiple use statements on same line -->
-    <rule ref="SlevomatCodingStandard.Namespaces.MultipleUsesPerLine"/>
-
-    <!-- Require newlines around namespace declaration -->
-    <rule ref="SlevomatCodingStandard.Namespaces.NamespaceSpacing"/>
-
-    <!-- Forbid using absolute class name references -->
-    <!-- <rule ref="SlevomatCodingStandard.Namespaces.ReferenceUsedNamesOnly"/> -->
-
-    <!-- Forbid superfluous leading backslash in use statements -->
-    <rule ref="SlevomatCodingStandard.Namespaces.UseDoesNotStartWithBackslash"/>
-
-    <!-- Forbid useless uses of the same namespace -->
-    <rule ref="SlevomatCodingStandard.Namespaces.UseFromSameNamespace"/>
-
-    <!-- Require empty newlines before and after uses -->
-    <rule ref="SlevomatCodingStandard.Namespaces.UseSpacing">
-        <properties>
-            <property name="linesCountAfterLastUse" value="1"/>
-            <property name="linesCountBeforeFirstUse" value="1"/>
-            <property name="linesCountBetweenUseTypes" value="1"/>
-        </properties>
-    </rule>
-
-    <!-- Forbid useless alias for classes, constants and functions -->
-    <rule ref="SlevomatCodingStandard.Namespaces.UselessAlias"/>
-
-    <!-- Forbid weak comparisons -->
-    <rule ref="SlevomatCodingStandard.Operators.DisallowEqualOperators"/>
-
-    <!-- Forbid spacing before the negative operator `-` -->
-    <rule ref="SlevomatCodingStandard.Operators.NegationOperatorSpacing"/>
-
-    <!-- Require the usage of assignment operators, eg `+=`, `.=` when possible -->
-    <rule ref="SlevomatCodingStandard.Operators.RequireCombinedAssignmentOperator"/>
-
-    <!-- Require no spacing after spread operator -->
-    <rule ref="SlevomatCodingStandard.Operators.SpreadOperatorSpacing"/>
-
-    <!-- Forbid `list(...)` syntax -->
-    <!-- <rule ref="SlevomatCodingStandard.PHP.ShortList"/> -->
-
-    <!-- Forbid use of longhand cast operators -->
-    <rule ref="SlevomatCodingStandard.PHP.TypeCast"/>
-
-    <!-- Forbid useless parentheses -->
-    <rule ref="SlevomatCodingStandard.PHP.UselessParentheses"/>
-
-    <!-- Forbid useless semicolon `;` -->
-    <rule ref="SlevomatCodingStandard.PHP.UselessSemicolon"/>
-
-    <!-- Require use of short versions of scalar types (i.e. int instead of integer) -->
-    <rule ref="SlevomatCodingStandard.TypeHints.LongTypeHints"/>
-
-    <!-- Require the `null` type hint to be in the last position of annotations -->
-    <rule ref="SlevomatCodingStandard.TypeHints.NullTypeHintOnLastPosition"/>
-
-    <!-- Require ? when default value is null -->
-    <!-- <rule ref="SlevomatCodingStandard.TypeHints.NullableTypeForNullDefaultValue"/> -->
-
-    <!-- Require one space between typehint and variable, require no space between nullability sign and typehint -->
-    <rule ref="SlevomatCodingStandard.TypeHints.ParameterTypeHintSpacing"/>
-
-    <!-- Require space around colon in return types -->
-    <rule ref="SlevomatCodingStandard.TypeHints.ReturnTypeHintSpacing">
-        <properties>
-            <property name="spacesCountBeforeColon" value="0"/>
-        </properties>
-    </rule>
-
-    <!-- Forbid useless @var for constants -->
-    <rule ref="SlevomatCodingStandard.TypeHints.UselessConstantTypeHint"/>
-
-    <!-- Forbid useless inherit doc comment -->
-    <rule ref="SlevomatCodingStandard.Commenting.UselessInheritDocComment"/>
-
-    <!-- Forbid duplicated variables assignments -->
-    <rule ref="SlevomatCodingStandard.Variables.DuplicateAssignmentToVariable"/>
-
-    <!-- Forbid useless variables -->
-    <rule ref="SlevomatCodingStandard.Variables.UselessVariable"/>
-
-    <!-- Forbid spaces around square brackets -->
-    <rule ref="Squiz.Arrays.ArrayBracketSpacing"/>
-
-    <!-- Forbid class being in a file with different name -->
-    <rule ref="Squiz.Classes.ClassFileName"/>
-
-    <!-- Force `self::` for self-reference, force lower-case self, forbid spaces around `::` -->
-    <rule ref="Squiz.Classes.SelfMemberReference"/>
-
-    <!-- Forbid global functions -->
-    <rule ref="Squiz.Functions.GlobalFunction"/>
-
-    <!-- Force camelCase variables -->
-    <rule ref="Squiz.NamingConventions.ValidVariableName">
-        <exclude name="Squiz.NamingConventions.ValidVariableName.PrivateNoUnderscore" />
-    </rule>
-
-    <!-- Force phpDoc alignment -->
-    <rule ref="Squiz.Commenting.DocCommentAlignment">
-        <!-- Allow extra spaces after star, i.e. for indented annotations -->
-        <exclude name="Squiz.Commenting.DocCommentAlignment.SpaceAfterStar"/>
-    </rule>
-
-    <!-- Force array declaration structure -->
-    <rule ref="Squiz.Arrays.ArrayDeclaration">
-        <!-- Disable arrow alignment -->
-        <exclude name="Squiz.Arrays.ArrayDeclaration.DoubleArrowNotAligned"/>
-        <!-- Uses indentation of only single space -->
-        <exclude name="Squiz.Arrays.ArrayDeclaration.KeyNotAligned"/>
-        <!-- Allow multiple values on a single line -->
-        <exclude name="Squiz.Arrays.ArrayDeclaration.SingleLineNotAllowed"/>
-        <!-- Disable alignment of braces -->
-        <exclude name="Squiz.Arrays.ArrayDeclaration.CloseBraceNotAligned"/>
-        <!-- Disable alignment of values with opening brace -->
-        <exclude name="Squiz.Arrays.ArrayDeclaration.ValueNotAligned"/>
-        <!-- Checked by SlevomatCodingStandard.Arrays.TrailingArrayComma.MissingTrailingComma -->
-        <exclude name="Squiz.Arrays.ArrayDeclaration.NoCommaAfterLast"/>
-        <exclude name="Squiz.Arrays.ArrayDeclaration.NoComma"/>
-    </rule>
-
-    <!-- Force rules for function phpDoc -->
-    <rule ref="Squiz.Commenting.FunctionComment">
-        <!-- Allow `@throws` without description -->
-        <exclude name="Squiz.Commenting.FunctionComment.EmptyThrows"/>
-        <!-- Does not work properly with PHP 7 / short-named types -->
-        <exclude name="Squiz.Commenting.FunctionComment.IncorrectParamVarName"/>
-        <!-- Does not support collections, i.e. `string[]` -->
-        <exclude name="Squiz.Commenting.FunctionComment.IncorrectTypeHint"/>
-        <!-- Forces incorrect types -->
-        <exclude name="Squiz.Commenting.FunctionComment.InvalidReturn"/>
-        <!-- Breaks with compound return types, i.e. `string|null` -->
-        <exclude name="Squiz.Commenting.FunctionComment.InvalidReturnNotVoid"/>
-        <!-- Breaks when all params are not documented -->
-        <exclude name="Squiz.Commenting.FunctionComment.InvalidTypeHint"/>
-        <!-- Doc comment is not required for every method -->
-        <exclude name="Squiz.Commenting.FunctionComment.Missing"/>
-        <!-- Do not require comments for `@param` -->
-        <exclude name="Squiz.Commenting.FunctionComment.MissingParamComment"/>
-        <!-- Do not require `@param` for all parameters -->
-        <exclude name="Squiz.Commenting.FunctionComment.MissingParamTag"/>
-        <!-- Do not require `@return` for void methods -->
-        <exclude name="Squiz.Commenting.FunctionComment.MissingReturn"/>
-        <!-- Comments don't have to be sentences -->
-        <exclude name="Squiz.Commenting.FunctionComment.ParamCommentFullFullStop"/>
-        <!-- Comments don't have to be sentences -->
-        <exclude name="Squiz.Commenting.FunctionComment.ParamCommentNotCapital"/>
-        <!-- Breaks when all params are not documented -->
-        <exclude name="Squiz.Commenting.FunctionComment.ParamNameNoMatch"/>
-        <!-- Doesn't respect inheritance -->
-        <exclude name="Squiz.Commenting.FunctionComment.ScalarTypeHintMissing"/>
-        <!-- `@throws` lines can often be read as a sentence,
-             i.e. `@throws RuntimeException if the file could not be written.` -->
-        <exclude name="Squiz.Commenting.FunctionComment.ThrowsNotCapital"/>
-        <!-- Doesn't work with self as typehint -->
-        <exclude name="Squiz.Commenting.FunctionComment.TypeHintMissing"/>
-    </rule>
-
-    <!-- Forbid `AND` and `OR`, require `&&` and `||` -->
-    <rule ref="Squiz.Operators.ValidLogicalOperators"/>
-
-    <!-- Forbid `global` -->
-    <rule ref="Squiz.PHP.GlobalKeyword"/>
-
-    <!-- Forbid functions inside functions -->
-    <rule ref="Squiz.PHP.InnerFunctions"/>
-
-    <!-- Require PHP function calls in lowercase -->
-    <rule ref="Squiz.PHP.LowercasePHPFunctions"/>
-
-    <!-- Forbid `$this` inside static function -->
-    <rule ref="Squiz.Scope.StaticThisUsage"/>
-
-    <!-- Force whitespace before and after concatenation -->
-    <!-- <rule ref="Squiz.Strings.ConcatenationSpacing">
-        <properties>
-            <property name="spacing" value="0"/>
-            <property name="ignoreNewlines" value="true"/>
-        </properties>
-    </rule> -->
-
-    <!-- Forbid dead code -->
-    <rule ref="Squiz.PHP.NonExecutableCode"/>
-
-    <!-- Forbid strings in `"` unless necessary -->
-    <rule ref="Squiz.Strings.DoubleQuoteUsage"/>
-    <rule ref="Squiz.Strings.DoubleQuoteUsage.ContainsVar">
-        <message>Variable "%s" not allowed in double quoted string; use sprintf() or concatenation instead</message>
-    </rule>
-
-    <!-- Forbid braces around string in `echo` -->
-    <rule ref="Squiz.Strings.EchoedStrings"/>
-
-    <!-- Forbid spaces in type casts -->
-    <rule ref="Squiz.WhiteSpace.CastSpacing"/>
-
-    <!-- Forbid blank line after function opening brace -->
-    <rule ref="Squiz.WhiteSpace.FunctionOpeningBraceSpace"/>
-
-    <!-- Require 1 line before and after function, except at the top and bottom -->
-    <rule ref="Squiz.WhiteSpace.FunctionSpacing">
-        <properties>
-            <property name="spacing" value="1" />
-            <property name="spacingBeforeFirst" value="0"/>
-            <property name="spacingAfterLast" value="0"/>
-        </properties>
-    </rule>
-
-    <!-- Require there be no space between increment/decrement operator and its operand -->
-    <rule ref="Generic.WhiteSpace.IncrementDecrementSpacing"/>
-
-    <!-- Require space after language constructs -->
-    <rule ref="Squiz.WhiteSpace.LanguageConstructSpacing"/>
-
-    <!-- Require space around logical operators -->
-    <rule ref="Squiz.WhiteSpace.LogicalOperatorSpacing"/>
-
-    <!-- Forbid spaces around `->` operator -->
-    <rule ref="Squiz.WhiteSpace.ObjectOperatorSpacing">
-        <properties>
-            <property name="ignoreNewlines" value="true"/>
-        </properties>
-    </rule>
-
-    <!-- Forbid spaces before semicolon `;` -->
-    <rule ref="Squiz.WhiteSpace.SemicolonSpacing"/>
-
-    <!-- Forbid superfluous whitespaces -->
-    <rule ref="Squiz.WhiteSpace.SuperfluousWhitespace">
-        <properties>
-            <!-- turned on by PSR2 -> turning back off -->
-            <property name="ignoreBlankLines" value="false"/>
-        </properties>
-    </rule>
-    <rule ref="Squiz.WhiteSpace.SuperfluousWhitespace.EmptyLines">
-        <!-- turned off by PSR2 -> turning back on -->
-        <severity>5</severity>
-    </rule>
-
-    <!-- Checks that class/trait/interface members are in the correct order. -->
-    <rule ref="SlevomatCodingStandard.Classes.ClassStructure"/>
-
-    <!-- Disallows use of continue without integer operand in switch because it emits a warning in PHP 7.3 and higher. -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.DisallowContinueWithoutIntegerOperandInSwitch"/>
-
-    <!-- Enforces reasonable end bracket placement for multiline arrays. -->
-    <rule ref="SlevomatCodingStandard.Arrays.MultiLineArrayEndBracketPlacement"/>
-
-    <!-- Checks that there is a certain number of blank lines between properties. -->
-    <rule ref="SlevomatCodingStandard.Classes.PropertySpacing"/>
-
-    <!-- Require consistent spacing for jump statements -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.JumpStatementsSpacing">
-        <properties>
-            <property name="tokensToCheck" type="array">
-                <element value="T_RETURN" />
-                <element value="T_THROW" />
-                <element value="T_YIELD" />
-                <element value="T_YIELD_FROM" />
-            </property>
-        </properties>
-    </rule>
-
-    <!-- Require consistent spacing for block structures -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.BlockControlStructureSpacing">
-        <exclude name="SlevomatCodingStandard.ControlStructures.BlockControlStructureSpacing.IncorrectLinesCountBeforeControlStructure" />
-        <exclude name="SlevomatCodingStandard.ControlStructures.BlockControlStructureSpacing.IncorrectLinesCountBeforeFirstControlStructure" />
-        <properties>
-            <property name="tokensToCheck" type="array">
-                <element value="T_IF" />
-                <element value="T_DO" />
-                <element value="T_WHILE" />
-                <element value="T_FOR" />
-                <element value="T_FOREACH" />
-                <element value="T_SWITCH" />
-                <element value="T_TRY" />
-                <element value="T_DEFAULT" />
-            </property>
-        </properties>
-    </rule>
-
-    <!-- Requires new with parentheses. -->
-    <rule ref="SlevomatCodingStandard.ControlStructures.NewWithParentheses"/>
-
-    <!-- Disallows usage of array type hint syntax (eg. int[], bool[][]) in phpDocs in favour of generic type hint syntax (eg. array<int>, array<array<bool>>) -->
-    <!--    <rule ref="SlevomatCodingStandard.TypeHints.DisallowArrayTypeHintSyntax" />-->
-</ruleset>

.phplint.yml

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

.phpstorm.meta.php

@@ -1,3 +0,0 @@
-<?php
-
-namespace PHPSTORM_META;

.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/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,93 @@
+# CHANGELOG for 2.x
+
+## [Unreleased](https://github.com/php-flasher/php-flasher/compare/v2.2.0...2.x)
+
+## [v2.5.0](https://github.com/php-flasher/php-flasher/compare/v2.1.4...v2.2.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)

DependencyInjection/Configuration.php

@@ -1,89 +0,0 @@
-<?php
-
-namespace Flasher\Toastr\Symfony\DependencyInjection;
-
-use Symfony\Component\Config\Definition\Builder\TreeBuilder;
-use Symfony\Component\Config\Definition\ConfigurationInterface;
-
-final class Configuration implements ConfigurationInterface
-{
-    /**
-     * {@inheritdoc}
-     */
-    public function getConfigTreeBuilder()
-    {
-        $treeBuilder = new TreeBuilder('flasher_toastr');
-
-        if (\method_exists($treeBuilder, 'getRootNode')) {
-            $rootNode = $treeBuilder->getRootNode();
-        } else {
-            // BC layer for symfony/config 4.1 and older
-            $rootNode = $treeBuilder->root('flasher_toastr');
-        }
-
-        $rootNode
-            ->children()
-                ->arrayNode('scripts')
-                    ->prototype('scalar')->end()
-                    ->defaultValue(array(
-                        'https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.min.js',
-                        'https://cdnjs.cloudflare.com/ajax/libs/toastr.js/2.1.4/toastr.min.js',
-                        '/bundles/flashertoastr/flasher-toastr.js',
-                    ))
-                ->end()
-                ->arrayNode('styles')
-                    ->prototype('scalar')->end()
-                    ->defaultValue(array(
-                        'https://cdnjs.cloudflare.com/ajax/libs/toastr.js/2.1.4/toastr.min.css',
-                    ))
-                ->end()
-                ->arrayNode('options')
-                    ->prototype('variable')->end()
-                    ->ignoreExtraKeys(false)
-                    ->defaultValue(array(
-                        'closeButton'       => true,
-                        'closeClass'        => 'toast-close-button',
-                        'closeDuration'     => 300,
-                        'closeEasing'       => 'swing',
-                        'closeHtml'         => '<button><i class="icon-off"></i></button>',
-                        'closeMethod'       => 'fadeOut',
-                        'closeOnHover'      => true,
-                        'containerId'       => 'toast-container',
-                        'debug'             => false,
-                        'escapeHtml'        => false,
-                        'extendedTimeOut'   => 10000,
-                        'hideDuration'      => 1000,
-                        'hideEasing'        => 'linear',
-                        'hideMethod'        => 'fadeOut',
-                        'iconClass'         => 'toast-info',
-                        'iconClasses'       => array(
-                            'error'   => 'toast-error',
-                            'info'    => 'toast-info',
-                            'success' => 'toast-success',
-                            'warning' => 'toast-warning',
-                        ),
-                        'messageClass'      => 'toast-message',
-                        'newestOnTop'       => false,
-                        'onHidden'          => null,
-                        'onShown'           => null,
-                        'positionClass'     => 'toast-top-right',
-                        'preventDuplicates' => false,
-                        'progressBar'       => true,
-                        'progressClass'     => 'toast-progress',
-                        'rtl'               => false,
-                        'showDuration'      => 300,
-                        'showEasing'        => 'swing',
-                        'showMethod'        => 'fadeIn',
-                        'tapToDismiss'      => true,
-                        'target'            => 'body',
-                        'timeOut'           => 5000,
-                        'titleClass'        => 'toast-title',
-                        'toastClass'        => 'toast',
-                    ))
-                ->end()
-            ->end()
-        ;
-
-        return $treeBuilder;
-    }
-}

DependencyInjection/FlasherToastrExtension.php

@@ -1,45 +0,0 @@
-<?php
-
-namespace Flasher\Toastr\Symfony\DependencyInjection;
-
-use Symfony\Component\Config\FileLocator;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface;
-use Symfony\Component\DependencyInjection\Loader;
-use Symfony\Component\HttpKernel\DependencyInjection\Extension;
-
-final class FlasherToastrExtension extends Extension implements PrependExtensionInterface
-{
-    /**
-     * {@inheritdoc}
-     *
-     * @throws \Exception
-     */
-    public function load(array $configs, ContainerBuilder $container)
-    {
-        $loader = new Loader\YamlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
-        $loader->load('config.yaml');
-
-        $configuration = new Configuration();
-        $this->processConfiguration($configuration, $configs);
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    public function prepend(ContainerBuilder $container)
-    {
-        if (!$container->hasExtension('flasher')) {
-            throw new \RuntimeException('[Flasher\Symfony\FlasherBundle] is not registered');
-        }
-
-        $configs = $container->getExtensionConfig($this->getAlias());
-        $config = $this->processConfiguration(new Configuration(), $configs);
-
-        $container->prependExtensionConfig('flasher', array(
-            'adapters' => array(
-                'toastr' => $config,
-            ),
-        ));
-    }
-}

FlasherToastrBundle.php

@@ -1,9 +0,0 @@
-<?php
-
-namespace Flasher\Toastr\Symfony;
-
-use Symfony\Component\HttpKernel\Bundle\Bundle;
-
-class FlasherToastrBundle extends Bundle
-{
-}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,51 +1,333 @@
-<p align="center"><img width="600" alt="notify" src="https://user-images.githubusercontent.com/10859693/100492861-fabfd800-3130-11eb-8c5e-242fff1706a9.png"></p>
-
-<h1 align="center">Easy flash notifications for PHP, Laravel, Symfony, Lumen</h1>
-
-<p align="center">:eyes: PHP Flasher library helps you to add flash notifications to your projects. This library was developed with the idea that you should be able to add flash notification to your application with ease and with few lines of code. No application-wide rewrites and no big investments upfront.</p>
+<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">
-    <a href="https://github.com/php-flasher/flasher">
-        <img src="https://img.shields.io/badge/source-php--notify/notify-blue.svg?style=flat-square">
-    </a>
-    <a href="https://github.com/php-flasher/flasher/releases">
-        <img src="https://img.shields.io/github/tag/php-flasher/flasher.svg">
-    </a>
-    <a href="https://github.com/php-flasher/flasher/blob/master/LICENSE">
-        <img src="https://img.shields.io/badge/license-MIT-brightgreen.svg">
-    </a>
-    <a href="https://packagist.org/packages/php-flasher/flasher">
-        <img src="https://img.shields.io/packagist/dt/php-flasher/flasher.svg">
-    </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">
-    </a>
+    <picture>
+      <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>
 
-## Introduction
+<h1 align="center">Elegant Flash Notifications for PHP</h1>
 
-PHP Flasher library helps you to add flash notifications to your projects. This library was developed with the idea that you should be able to add flash notification to your application with ease and with few lines of code. No application-wide rewrites and no big investments upfront.
+<p align="center">
+    <strong>One line of PHP. Beautiful notifications. Zero JavaScript.</strong>
+</p>
 
-# Why use PHP Flasher ?
+<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>
 
-The PHP Flasher project supports a variety of notification libraries : __toastr.js__, __sweet alert 2__, __pnotify__ and __notyf__
-and its highly extendable so you can add custom adapters.
+<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>
 
-This library is designed, so you can take full control when creating you notifications :
+---
 
-> * Display multiple notifications
-> * Sort and filter notifications
-> * Render notification from JSON response with Ajax or Websockets
-> * Limit the number of displayed notifications
-> * Show notifications from different adapters at the same time
-> * implementations for popular frameworks : Symfony and Laravel
-> * ...and more
+## Quick Start
 
+**Laravel:**
+```bash
+composer require php-flasher/flasher-laravel && php artisan flasher:install
+```
 
-## Official Documentation
+**Symfony:**
+```bash
+composer require php-flasher/flasher-symfony && php bin/console flasher:install
+```
 
-Documentation for Valet can be found on the [PHP Flasher website](https://php-flasher.github.io/).
+**That's it!** Now use it:
+
+```php
+flash()->success('Welcome aboard! Your account is ready.');
+```
+
+---
+
+## Why PHPFlasher?
+
+| | 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 |
+
+---
+
+## Notification Types
+
+```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.');
+```
+
+### 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
 
-PHP Flasher 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">
+    <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>

Resources/config/config.yaml

@@ -1,8 +0,0 @@
-services:
-    flasher.toastr:
-        parent: 'flasher.notification_factory'
-        class: Flasher\Toastr\Prime\ToastrFactory
-        tags:
-            - { name: 'flasher.factory', alias: 'toastr' }
-
-    Flasher\Toastr\Prime\ToastrFactory: '@flasher.toastr'

Resources/public/flasher-toastr.js

@@ -1,16 +0,0 @@
-PHPFlasher.addFactory('toastr', (function () {
-    'use strict';
-
-    var exports = {};
-
-    exports.render = function (data) {
-        var notification = data.notification;
-        toastr[notification.type](notification.message, notification.title, notification.options);
-    };
-
-    exports.renderOptions = function (options) {
-        toastr.options = options;
-    };
-
-    return exports;
-})());

Tests/DependencyInjection/ConfigurationTest.php

@@ -1,82 +0,0 @@
-<?php
-
-namespace Flasher\Toastr\Symfony\Tests\DependencyInjection;
-
-use Flasher\Prime\Tests\TestCase;
-use Flasher\Toastr\Symfony\DependencyInjection\Configuration;
-use Symfony\Component\Config\Definition\Processor;
-
-class ConfigurationTest extends TestCase
-{
-    public function testDefaultConfig()
-    {
-        $config = $this->process(array());
-
-        $expected = array(
-            'scripts'                  => array(
-                'https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.min.js',
-                'https://cdnjs.cloudflare.com/ajax/libs/toastr.js/2.1.4/toastr.min.js',
-                '/bundles/flashertoastr/flasher-toastr.js',
-            ),
-            'styles'                   => array(
-                'https://cdnjs.cloudflare.com/ajax/libs/toastr.js/2.1.4/toastr.min.css',
-            ),
-            'options' =>array(
-                        'closeButton'       => true,
-                        'closeClass'        => 'toast-close-button',
-                        'closeDuration'     => 300,
-                        'closeEasing'       => 'swing',
-                        'closeHtml'         => '<button><i class="icon-off"></i></button>',
-                        'closeMethod'       => 'fadeOut',
-                        'closeOnHover'      => true,
-                        'containerId'       => 'toast-container',
-                        'debug'             => false,
-                        'escapeHtml'        => false,
-                        'extendedTimeOut'   => 10000,
-                        'hideDuration'      => 1000,
-                        'hideEasing'        => 'linear',
-                        'hideMethod'        => 'fadeOut',
-                        'iconClass'         => 'toast-info',
-                        'iconClasses'       => array(
-                            'error'   => 'toast-error',
-                            'info'    => 'toast-info',
-                            'success' => 'toast-success',
-                            'warning' => 'toast-warning',
-                        ),
-                        'messageClass'      => 'toast-message',
-                        'newestOnTop'       => false,
-                        'onHidden'          => null,
-                        'onShown'           => null,
-                        'positionClass'     => 'toast-top-right',
-                        'preventDuplicates' => false,
-                        'progressBar'       => true,
-                        'progressClass'     => 'toast-progress',
-                        'rtl'               => false,
-                        'showDuration'      => 300,
-                        'showEasing'        => 'swing',
-                        'showMethod'        => 'fadeIn',
-                        'tapToDismiss'      => true,
-                        'target'            => 'body',
-                        'timeOut'           => 5000,
-                        'titleClass'        => 'toast-title',
-                        'toastClass'        => 'toast',
-                    )
-        );
-
-        $this->assertSame($expected, $config);
-    }
-
-    /**
-     * Processes an array of configurations and returns a compiled version.
-     *
-     * @param array $configs An array of raw configurations
-     *
-     * @return array A normalized array
-     */
-    private function process($configs)
-    {
-        $processor = new Processor();
-
-        return $processor->processConfiguration(new Configuration(), $configs);
-    }
-}

Tests/DependencyInjection/FlasherToastrExtensionTest.php

@@ -1,77 +0,0 @@
-<?php
-
-namespace Flasher\Toastr\Symfony\Tests\DependencyInjection;
-
-use Flasher\Prime\Tests\TestCase;
-use Flasher\Symfony\DependencyInjection\FlasherExtension;
-use Flasher\Symfony\FlasherBundle;
-use Flasher\Toastr\Symfony\DependencyInjection\FlasherToastrExtension;
-use Flasher\Toastr\Symfony\FlasherToastrBundle;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-class FlasherToastrExtensionTest extends TestCase
-{
-    public function testContainerContainFlasherServices()
-    {
-        $container = $this->getRawContainer();
-        $container->loadFromExtension('flasher', array());
-        $container->loadFromExtension('flasher_toastr', array());
-        $container->compile();
-
-        $this->assertTrue($container->has('flasher.toastr'));
-    }
-
-    public function testCreateInstanceOfToastrAdapter()
-    {
-        $container = $this->getRawContainer();
-        $container->loadFromExtension('flasher');
-        $container->loadFromExtension('flasher_toastr');
-        $container->compile();
-
-        $flasher = $container->getDefinition('flasher');
-        $calls = $flasher->getMethodCalls();
-
-        $this->assertCount(2, $calls);
-        $this->assertSame('addFactory', $calls[0][0]);
-        $this->assertSame('template', $calls[0][1][0]);
-        $this->assertSame('flasher.notification_factory', (string) $calls[0][1][1]);
-
-        $this->assertSame('addFactory', $calls[1][0]);
-        $this->assertSame('toastr', $calls[1][1][0]);
-        $this->assertSame('flasher.toastr', (string) $calls[1][1][1]);
-    }
-
-    public function testConfigurationInjectedIntoFlasherConfig()
-    {
-        $container = $this->getContainer();
-        $config = $container->get('flasher.config');
-        $this->assertNotEmpty($config->get('adapters.toastr'));
-    }
-
-    private function getRawContainer()
-    {
-        $container = new ContainerBuilder();
-
-        $container->registerExtension(new FlasherExtension());
-        $flasherBundle = new FlasherBundle();
-        $flasherBundle->build($container);
-
-        $container->registerExtension(new FlasherToastrExtension());
-        $adapterBundle = new FlasherToastrBundle();
-        $adapterBundle->build($container);
-
-        $container->getCompilerPassConfig()->setOptimizationPasses(array());
-        $container->getCompilerPassConfig()->setRemovingPasses(array());
-        $container->getCompilerPassConfig()->setAfterRemovingPasses(array());
-
-        return $container;
-    }
-
-    private function getContainer()
-    {
-        $container = $this->getRawContainer();
-        $container->compile();
-
-        return $container;
-    }
-}

bin/assets

@@ -0,0 +1,675 @@
+#!/usr/bin/env bash
+
+# =========================================================================
+# 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
+# =========================================================================
+
+# Strict error handling
+set -o pipefail
+
+# =========================================================================
+# CONSTANTS AND CONFIGURATION
+# =========================================================================
+
+# 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'
+
+# Emoji indicators
+readonly ROCKET="🚀"
+readonly PACKAGE="📦"
+readonly CHECK="✓"
+readonly ERROR="❌"
+readonly WARNING="⚠️"
+readonly HAMMER="🏗️"
+readonly CHART="📊"
+readonly SPARKLES="✨"
+readonly HOURGLASS="⏳"
+readonly PALETTE="🎨"
+
+# 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"
+
+# Default configuration
+VERBOSE=false
+WATCH_MODE=false
+THEME_ONLY=false
+MODULE_ONLY=false
+ANALYZE=false
+DEEP_ANALYZE=false
+SKIP_CLEAR=false
+NODE_ENV="production"
+
+# =========================================================================
+# UTILITY FUNCTIONS
+# =========================================================================
+
+cleanup() {
+    # Clean up temporary files when the script exits
+    rm -rf "${TEMP_DIR}" 2>/dev/null
+}
+
+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

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# Default to the current directory if no directory is provided
+dir=${1:-.}
+
+# Optional: A list of file extensions to filter by, e.g., "txt md". Leave empty to include all files.
+extensions=($2)
+
+# Temporary file to store results
+temp_file=$(mktemp)
+
+# 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

@@ -0,0 +1,243 @@
+#!/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 SKIP="⏭️"
+
+# 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"
+)
+
+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"
+}
+
+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}%"
+}
+
+check_tag_exists() {
+    local repo=$1
+    local tag=$2
+    local remote_url="git@github.com:php-flasher/$repo.git"
+
+    if git ls-remote --tags "$remote_url" | grep -q "refs/tags/$tag$"; then
+        return 0
+    else
+        return 1
+    fi
+}
+
+release_repository() {
+    local repo=$1
+    local version=$2
+    local tmp_dir="/tmp/php-flasher"
+    local remote_url="git@github.com:php-flasher/$repo.git"
+
+    echo -e "\nGitHub : ${UNDERLINE}${BLUE}https://github.com/php-flasher/${repo}${RESET}"
+    echo -e "Tag    : ${YELLOW}$version${RESET}"
+
+    if check_tag_exists "$repo" "$version"; then
+        echo -e "${SKIP} ${YELLOW}Tag $version already exists, skipping...${RESET}"
+        return 0
+    fi
+
+    # Clean and create temporary directory
+    rm -rf "$tmp_dir"
+    mkdir -p "$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"
+        echo -e "${CYAN}Creating tag $version...${RESET}"
+        git checkout "$RELEASE_BRANCH" >/dev/null 2>&1
+        git tag "$version"
+
+        if ! git push origin --tags --force >/dev/null 2>&1; then
+            echo -e "${ERROR} ${RED}Failed to push tag${RESET}"
+            return 1
+        fi
+    )
+
+    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

@@ -0,0 +1,154 @@
+#!/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="❌"
+
+# Repository mappings
+declare -A REPOSITORIES=(
+    # Core packages
+    ["src/Prime"]="flasher"
+    ["src/Laravel"]="flasher-laravel"
+    ["src/Symfony"]="flasher-symfony"
+
+    # Toastr packages
+    ["src/Toastr/Prime"]="flasher-toastr"
+    ["src/Toastr/Laravel"]="flasher-toastr-laravel"
+    ["src/Toastr/Symfony"]="flasher-toastr-symfony"
+
+    # Notyf packages
+    ["src/Notyf/Prime"]="flasher-notyf"
+    ["src/Notyf/Laravel"]="flasher-notyf-laravel"
+    ["src/Notyf/Symfony"]="flasher-notyf-symfony"
+
+    # SweetAlert packages
+    ["src/SweetAlert/Prime"]="flasher-sweetalert"
+    ["src/SweetAlert/Laravel"]="flasher-sweetalert-laravel"
+    ["src/SweetAlert/Symfony"]="flasher-sweetalert-symfony"
+
+    # Noty packages
+    ["src/Noty/Prime"]="flasher-noty"
+    ["src/Noty/Laravel"]="flasher-noty-laravel"
+    ["src/Noty/Symfony"]="flasher-noty-symfony"
+)
+
+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"
+}
+
+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}"
+
+    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"
+
+    # 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,56 +1,106 @@
 {
-    "name": "php-flasher/flasher-toastr-symfony",
-    "type": "symfony-bundle",
-    "description": "PHP Flasher Symfony adapter for Toastr",
-    "keywords": [
-        "yoeunes",
-        "notify",
-        "php",
-        "laravel",
-        "symfony",
-        "Lumen",
-        "notifications",
-        "messages",
-        "alerts",
-        "pnotify",
-        "toastr ",
-        "bundle",
-        "flex"
-    ],
-    "homepage": "https://github.com/php-flasher/flasher-symfony-toastr",
+    "name": "php-flasher/php-flasher",
+    "type": "library",
+    "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://github.com/yoeunes",
+            "name": "Younes ENNAJI",
+            "email": "younes.ennaji.pro@gmail.com",
+            "homepage": "https://www.linkedin.com/in/younes--ennaji/",
             "role": "Developer"
         }
     ],
-    "license": "MIT",
+    "minimum-stability": "dev",
+    "prefer-stable": true,
     "require": {
-        "php": ">=5.3",
-        "php-flasher/flasher-symfony": "^0.1",
-        "php-flasher/flasher-toastr": "^0.1"
+        "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": {
-        "phpunit/phpunit": "^4.8|^5.0|^6.0|^7.0|^8.0|^9.0"
+        "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\\Toastr\\Symfony\\": ""
+            "Flasher\\": "src/"
         },
-        "exclude-from-classmap": [
-            "/Tests/"
+        "files": [
+            "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"
         ]
     },
     "autoload-dev": {
         "psr-4": {
-            "Flasher\\Toastr\\Symfony\\Tests\\": "Tests/"
+            "Flasher\\Tests\\": "tests/"
         }
     },
     "config": {
+        "preferred-install": "dist",
         "sort-packages": true
     },
-    "minimum-stability": "dev",
-    "prefer-stable": true
+    "extra": {
+        "phpstan": {
+            "includes": [
+                "extension.neon"
+            ]
+        },
+        "laravel": {
+            "providers": [
+                "Flasher\\Laravel\\FlasherServiceProvider",
+                "Flasher\\Noty\\Laravel\\FlasherNotyServiceProvider",
+                "Flasher\\Notyf\\Laravel\\FlasherNotyfServiceProvider",
+                "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"
+            }
+        }
+    }
 }

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.2

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.2",
+        "inertiajs/inertia-laravel": "^2.0",
+        "laravel/framework": "^12.0",
+        "laravel/tinker": "^2.10",
+        "livewire/livewire": "^3.6",
+        "php-flasher/php-flasher": "@dev",
+        "spatie/laravel-csp": "^2.10",
+        "spatie/laravel-ray": "^1.40"
+    },
+    "require-dev": {
+        "barryvdh/laravel-debugbar": "^3.15",
+        "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": "^3.7",
+        "pestphp/pest-plugin-laravel": "^3.1",
+        "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,218 @@
+<?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 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 */