Added the ability for a fully-accessible, page blocking modal

Author: PavlosIsaris

CHANGELOG.md

@@ -5,6 +5,40 @@ All notable changes to `laravel-cookie-guard` will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## v4.1.0 - Improved Accessibility & Bug Fixes - 2025-04-03
+
+We have decided to give the developers the ability to use the pure `<dialog>` HTML element functionality for our cookie
+consent component to enhance accessibility and ensure compliance with privacy regulations.
+
+The `<dialog>` element is designed to create a modal dialog that captures the user's focus, preventing interaction with
+the rest of the webpage
+until the dialog is dismissed.
+This approach ensures that users must make a choice regarding cookie consent before they
+can continue using the website.
+
+By using the `<dialog>` element, we achieve the following benefits:
+
+1. **Improved Accessibility:** The `<dialog>` element is natively supported by modern browsers and provides built-in
+   accessibility features. It ensures that screen readers and other assistive technologies can properly announce the
+   dialog and its contents to users with disabilities.
+
+
+2. **Focus Management:** When the dialog is open, it automatically captures the focus, preventing users from navigating
+   outside of it. This ensures that users cannot interact with other parts of the website until they have accepted or
+   rejected the cookies, making the consent process clear and unavoidable.
+
+
+3. **Compliance with Privacy Regulations:** By requiring users to make a choice before continuing to use the website, we
+   ensure compliance with privacy regulations such as the GDPR. This approach guarantees that users are informed about
+   and consent to the use of cookies before any data is collected.
+
+Overall, the use of the `<dialog>` element enhances the user experience by providing a clear and accessible way to
+manage cookie consent, ensuring that all users can interact with our website in a compliant and user-friendly manner.
+
+This functionality is now the **default behavior of the plugin**, and it can be disabled by setting the new
+`use_floating_modal`
+flag in the `config/cookies_consent.php` file to `true`.
+
 ## v4.0.0 - Multilingual Support & Better Theming - Breaking Changes in Configuration and Functionality - 2025-03-07
 
 The plugin is now renamed to `laravel-cookie-guard` and has undergone some major updates! 🎉🥳😍
@@ -22,19 +56,22 @@ composer require scify/laravel-cookie-guard
 php artisan vendor:publish --provider="SciFY\LaravelCookiesConsent\LaravelCookiesConsentServiceProvider" --tag="cookies-consent-public" --force
 ```
 
-Then, make sure to check the configuration file `config/cookies_consent.php` and update it according to [the new one](config/cookies_consent.php).
+Then, make sure to check the configuration file `config/cookies_consent.php` and update it according
+to [the new one](config/cookies_consent.php).
 
 Then, make sure that the Laravel components you use are the new ones:
 
 Intead of using:
 
 ```html
+
 <x-laravel-cookies-consent></x-laravel-cookies-consent>
 ```
 
 Use:
 
 ```html
+
 <x-laravel-cookie-guard-scripts></x-laravel-cookie-guard-scripts>
 <x-laravel-cookie-guard></x-laravel-cookie-guard>
 ```
@@ -77,13 +114,13 @@ If you want to override the CSS styles of the cookies consent dialog, you can do
 
 <x-laravel-cookie-guard></x-laravel-cookie-guard>
 <style>
-    #scify-cookies-consent {
-        --scify-cookies-primary-color: #ff5722; /* Override primary color */
+  #scify-cookies-consent {
+    --scify-cookies-primary-color: #ff5722; /* Override primary color */
 
-        ...
+    ...
 
-        /* Add more override rules here */
-    }
+    /* Add more override rules here */
+  }
 </style>
 ```
 

README.md

@@ -1,4 +1,5 @@
 <!-- omit in toc -->
+
 # Laravel Cookie Guard - Make your Laravel app compliant with the EU GDPR cookie law
 
 The **last** Cookies Consent Plugin your **Laravel app** will ever need!
@@ -22,6 +23,7 @@ The **last** Cookies Consent Plugin your **Laravel app** will ever need!
 [![GitHub closed pull-requests](https://img.shields.io/github/issues-pr-closed/scify/laravel-cookie-guard)](https://github.com/scify/laravel-cookie-guard/pulls?q=is%3Apr+is%3Aclosed)
 
 <!-- omit in toc -->
+
 ## Table of Contents
 
 - [Upgrading to v4](#upgrading-to-v4)
@@ -192,6 +194,7 @@ return [
     'hide_floating_button_on_mobile' => false, // Set to true to hide the floating button on mobile
     'use_separate_page' => false, // Set to true to use a separate page for cookies explanation
     'categories_collapsed_by_default' => true, // Set to false to initially collapse the optional categories
+    'use_show_modal' => true, // Set to false to disable the use of showModal() on the dialog HTML element
     /*
     |--------------------------------------------------------------------------
     | Editor
@@ -271,6 +274,9 @@ The `categories_collapsed_by_default` field is optional and, if set to `false`,
 categories.
 If set to `true`, all categories will be collapsed by default.
 
+The `use_floating_modal` field is optional and, if set to `true`, will disable the use of `showModal()` on the dialog HTML,
+and the fully-accessible modal.
+
 You can add as many cookie categories as you like, simply by adding values to the `cookies` array.
 
 If you want to remove a cookie category, simply remove it from the array.
@@ -651,8 +657,7 @@ Or, to prune everything and re-install:
 rm -rf public/vendor/scify && \
 rm -rf vendor/scify && \
 composer require scify/laravel-cookie-guard && \
-php artisan vendor:publish --provider="SciFY\LaravelCookiesConsent\LaravelCookiesConsentServiceProvider" --tag="cookies-consent-public" --force && \
-php artisan config:cache
+php artisan vendor:publish --provider="SciFY\LaravelCookiesConsent\LaravelCookiesConsentServiceProvider" --tag="cookies-consent-public" --force
 ```
 
 ### Testing

composer.json

@@ -23,17 +23,17 @@
         "php": "^8"
     },
     "require-dev": {
-        "larastan/larastan": "^3.1",
-        "laravel/pint": "^1.6",
-        "nunomaduro/collision": "^8.0",
+        "larastan/larastan": "^3.2",
+        "laravel/pint": "^1.21",
+        "nunomaduro/collision": "^8.7",
         "orchestra/testbench": "^10.0",
-        "pestphp/pest": "^3.7",
+        "pestphp/pest": "^3.8",
         "pestphp/pest-plugin-laravel": "^v3.1",
         "phpstan/extension-installer": "^1.1",
         "phpstan/phpstan-deprecation-rules": "^2.0",
         "phpstan/phpstan-phpunit": "^2.0",
         "phpunit/phpunit": "^11.5",
-        "spatie/laravel-ray": "^1.39"
+        "spatie/laravel-ray": "^1.40"
     },
     "autoload": {
         "psr-4": {