Fork package and update dependencies for Laravel 12 and PHP 8.4 support

Author: kargnas

.windsurfrules

@@ -0,0 +1,22 @@
+# Laravel Localized Routes - Claude Guide
+
+## Commands
+- Run all tests: `composer test`
+- Run single test: `./vendor/bin/phpunit --filter=TestName`
+- Run test suite: `./vendor/bin/phpunit --testsuite=Unit` or `--testsuite=Feature`
+
+## Code Style
+- PSR-4 autoloading standard with `CodeZero\LocalizedRoutes\` namespace
+- Method visibility: public methods first, then protected, then private
+- DocBlocks for all methods with `@return` types
+- Type hints for method parameters and return types where possible
+- Protected properties with descriptive names
+- Explicit imports (no group imports)
+- Laravel naming conventions for classes and methods
+- Error handling through exceptions with descriptive messages
+
+## Development
+- PHP 8.1+ required
+- Laravel 10+ compatibility maintained
+- Tests cover all functionality
+- Follows semantic versioning

README.md

@@ -1,17 +1,19 @@
 # Laravel Localized Routes
 
-[![GitHub release](https://img.shields.io/github/release/codezero-be/laravel-localized-routes.svg?style=flat-square)](https://github.com/codezero-be/laravel-localized-routes/releases)
-[![Laravel](https://img.shields.io/badge/laravel-11-red?style=flat-square&logo=laravel&logoColor=white)](https://laravel.com)
-[![License](https://img.shields.io/packagist/l/codezero/laravel-localized-routes.svg?style=flat-square)](LICENSE.md)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/codezero-be/laravel-localized-routes/run-tests.yml?style=flat-square&logo=github&logoColor=white&label=tests)](https://github.com/codezero-be/laravel-localized-routes/actions)
-[![Code Coverage](https://img.shields.io/codacy/coverage/a5db8a1321664e67900c96eadc575ece/master?style=flat-square)](https://app.codacy.com/gh/codezero-be/laravel-localized-routes)
-[![Code Quality](https://img.shields.io/codacy/grade/a5db8a1321664e67900c96eadc575ece/master?style=flat-square)](https://app.codacy.com/gh/codezero-be/laravel-localized-routes)
-[![Total Downloads](https://img.shields.io/packagist/dt/codezero/laravel-localized-routes.svg?style=flat-square)](https://packagist.org/packages/codezero/laravel-localized-routes)
+[![GitHub release](https://img.shields.io/github/release/opgginc/codezero-laravel-localized-routes.svg?style=flat-square)](https://github.com/opgginc/codezero-laravel-localized-routes/releases)
+[![Laravel](https://img.shields.io/badge/laravel-12-red?style=flat-square&logo=laravel&logoColor=white)](https://laravel.com)
+[![License](https://img.shields.io/packagist/l/opgginc/codezero-laravel-localized-routes.svg?style=flat-square)](LICENSE.md)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/opgginc/codezero-laravel-localized-routes/run-tests.yml?style=flat-square&logo=github&logoColor=white&label=tests)](https://github.com/opgginc/codezero-laravel-localized-routes/actions)
+[![Total Downloads](https://img.shields.io/packagist/dt/opgginc/codezero-laravel-localized-routes.svg?style=flat-square)](https://packagist.org/packages/opgginc/codezero-laravel-localized-routes)
 
 [![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/R6R3UQ8V)
 
 A convenient way to set up and use localized routes in a Laravel app.
 
+## Important Note
+
+This package is a fork of the original [codezero/laravel-localized-routes](https://github.com/codezero-be/laravel-localized-routes) created by Ivan Vermeyen. It was forked by OP.GG Inc. to maintain and extend its functionality after the unfortunate passing of Ivan. We are deeply grateful for Ivan's contribution to the Laravel community and hope to honor his legacy by continuing to maintain this package. Rest in peace, Ivan.
+
 ## 📖 Table of Contents
 
 - [Requirements](#-requirements)
@@ -53,8 +55,8 @@ A convenient way to set up and use localized routes in a Laravel app.
 
 ## ✅ Requirements
 
-- PHP >= 8.1
-- Laravel >= 10
+- PHP >= 8.1, >= 8.4
+- Laravel >= 10, >= 12
 - Composer ^2.3 (for [codezero/composer-preload-files](https://github.com/codezero-be/composer-preload-files))
 
 ## ⬆ Upgrade
@@ -67,7 +69,7 @@ Check our [upgrade guide](UPGRADE.md) for instructions.
 Install this package with Composer:
 
 ```bash
-composer require codezero/laravel-localized-routes
+composer require opgginc/codezero-laravel-localized-routes
 ```
 
 Laravel will automatically register the ServiceProvider.
@@ -159,7 +161,7 @@ Make sure to add it after `StartSession` and before `SubstituteBindings`.
 The order of the middleware is important if you are using localized route keys (translated slugs)!
 The session needs to be active when setting the locale, and the locale needs to be set when substituting the route bindings.
 
-### Laravel 11 and newer:
+### Laravel 11 and 12:
 
 Add the middleware to the `web` middleware group in `bootstrap/app.php`.
 
@@ -304,7 +306,7 @@ public function resolveRouteBinding($value, $field = null)
 
 ### ☑ Translate Hard-Coded URI Slugs
 
-This package includes [codezero/laravel-uri-translator](https://github.com/codezero-be/laravel-uri-translator).
+This package includes [opgginc/codezero-laravel-uri-translator](https://github.com/opgginc/codezero-laravel-uri-translator).
 This registers a `Lang::uri()` macro that enables you to translate individual, hard-coded URI slugs.
 Route parameters will not be translated by this macro.
 
@@ -752,16 +754,17 @@ composer test
 ## ☕ Credits
 
 - [Ivan Vermeyen](https://github.com/ivanvermeyen)
-- [All contributors](https://github.com/codezero-be/laravel-localized-routes/contributors)
+- [OP.GG Inc.](https://github.com/opgginc)
+- [All contributors](https://github.com/opgginc/codezero-laravel-localized-routes/contributors)
 
 ## 🔒 Security
 
-If you discover any security related issues, please [e-mail me](mailto:ivan@codezero.be) instead of using the issue tracker.
+If you discover any security related issues, please contact us via GitHub issues.
 
 ## 📑 Changelog
 
 A complete list of all notable changes to this package can be found on the
-[releases page](https://github.com/codezero-be/laravel-localized-routes/releases).
+[releases page](https://github.com/opgginc/codezero-laravel-localized-routes/releases).
 
 ## 📜 License
 

UPGRADE.md

@@ -1,13 +1,35 @@
 # Upgrade Guide
 
+## Upgrading To 5.0 From 4.x
+
+### ➡ Package Name Changed
+
+The package name has been changed from `codezero/laravel-localized-routes` to `opgginc/codezero-laravel-localized-routes`.
+
+🔸 **Actions Required**
+
+- Update the package using Composer: `composer require opgginc/codezero-laravel-localized-routes`
+
+### ➡ Added Support for Laravel 12 and PHP 8.4
+
+This package now supports Laravel 12 and PHP 8.4.
+
+- The dependency `codezero/laravel-uri-translator` has been replaced with `opgginc/codezero-laravel-uri-translator`.
+
+🔸 **Actions Required**
+
+- If you are directly using `codezero/laravel-uri-translator`, update it to `opgginc/codezero-laravel-uri-translator`.
+
+---
+
 ## Upgrading To 4.0 From 3.x
 
 ### ➡ Minimum Requirements Updated
 
-Due to PHP and PHPUnit version constraints with Laravel 11, we dropped support for Laravel 7.x, 8.x and 9.x.
+Due to PHP and PHPUnit version constraints with Laravel 11+, we dropped support for Laravel 7.x, 8.x and 9.x.
 
-- The minimum PHP version required is now 8.1
-- The minimum Laravel version required is now 10
+- The minimum PHP version required is now 8.1 (and supports PHP 8.4)
+- The minimum Laravel version required is now 10 (and supports Laravel 12)
 
 ---
 
@@ -18,7 +40,7 @@ This is now handled in `bootstrap/app.php`.
 
 🔸 **Actions Required**
 
-If you use Laravel 11, register the middleware in `bootstrap/app.php` as described in the README.
+If you use Laravel 11 or 12, register the middleware in `bootstrap/app.php` as described in the README.
 
 ## Upgrading To 3.0 From 2.x
 

composer.json

@@ -1,5 +1,5 @@
 {
-    "name": "codezero/laravel-localized-routes",
+    "name": "opgginc/codezero-laravel-localized-routes",
     "description": "A convenient way to set up, manage and use localized routes in a Laravel app.",
     "keywords": [
         "php",
@@ -20,17 +20,17 @@
         }
     ],
     "require": {
-        "php": "^8.1",
+        "php": "^8.1|^8.4",
         "codezero/browser-locale": "^3.0",
         "codezero/composer-preload-files": "^1.0",
-        "codezero/laravel-uri-translator": "^2.0",
+        "opgginc/codezero-laravel-uri-translator": "^2.0",
         "codezero/php-url-builder": "^1.0",
-        "illuminate/support": "^10.0|^11.0"
+        "illuminate/support": "^10.0|^11.0|^12.0"
     },
     "require-dev": {
         "mockery/mockery": "^1.3.3",
-        "orchestra/testbench": "^8.0|^9.0",
-        "phpunit/phpunit": "^10.5"
+        "orchestra/testbench": "^8.0|^9.0|^10.0",
+        "phpunit/phpunit": "^10.5|^11.0"
     },
     "scripts": {
         "test": "phpunit"