Added the laravel-lang/locales package

Author: andrey-helldar

composer.json

@@ -46,15 +46,16 @@
     },
     "require": {
         "php": "^8.1",
-        "laravel-lang/attributes": "^2.3.3",
-        "laravel-lang/http-statuses": "^3.3.1",
-        "laravel-lang/lang": "^13.0",
-        "laravel-lang/publisher": "^14.6.4"
+        "laravel-lang/attributes": "^2.4.1",
+        "laravel-lang/http-statuses": "^3.4.5",
+        "laravel-lang/lang": "^13.2.8",
+        "laravel-lang/locales": "^1.0",
+        "laravel-lang/publisher": "^14.7.0"
     },
     "require-dev": {
-        "orchestra/testbench": "^8.5 || ^9.0",
-        "phpunit/phpunit": "^10.0",
-        "symfony/var-dumper": "^6.3"
+        "orchestra/testbench": "^8.14",
+        "phpunit/phpunit": "^10.4.2",
+        "symfony/var-dumper": "^6.3.6"
     },
     "minimum-stability": "stable",
     "prefer-stable": true,
@@ -66,8 +67,8 @@
     "config": {
         "allow-plugins": {
             "composer/package-versions-deprecated": true,
-            "ergebnis/composer-normalize": true,
             "dragon-code/codestyler": true,
+            "ergebnis/composer-normalize": true,
             "friendsofphp/php-cs-fixer": true,
             "symfony/thanks": true
         },

docs/.vuepress/config.js

@@ -59,7 +59,8 @@ module.exports = {
                 collapsible: true,
                 children: [
                     '/installation/upgrade-guide/index.md',
-                    '/installation/compatibility/support-policy.md'
+                    '/installation/compatibility/support-policy.md',
+                    '/installation/about.md'
                 ]
             },
             {

docs/installation/about.md

@@ -0,0 +1,77 @@
+# About
+
+Below is a list of projects we are developing with a description of their purpose.
+
+## `laravel-lang/common`
+
+This package is needed for quick installation and updating of all our projects.
+
+When installing it, all the main packages necessary for working with localizations and translations will be installed
+in the application.
+
+## `laravel-lang/locales`
+
+This package contains the core mechanics for working with locales.
+
+It can display the following lists of locales:
+
+- available for installation
+- installed locales
+- not installed locales
+- protected localizations
+
+It can also check that the locale:
+
+- available for installation
+- installed in the application
+- is protected
+
+In addition, the package can receive the main and backup locales and check them for validity.
+
+It can also work with locale aliases.
+
+## `laravel-lang/publisher`
+
+This package is needed to install translations from plug-in packages.
+
+For example, `laravel-lang/lang`.
+
+## `laravel-lang/lang`
+
+This project contains translations of all available official project keys from the [Laravel](https://laravel.com) team:
+
+- Breeze
+- Cashier Stripe
+- Fortify
+- Jetstream
+- Nova
+- Spark Aurelius Mollie
+- Spark Aurelius
+- Spark Paddle
+- Spark Stripe
+- UI
+- Laravel Framework
+- Lumen Framework
+
+## `laravel-lang/attributes`
+
+This project contains the translation of custom names for form fields. The list of fields is determined by contributors
+and translated by our community.
+
+The specified keys are set to the `attributes` section of the validation error file.
+
+## `laravel-lang/http-statuses`
+
+This project contains translations of all HTTP statuses.
+
+## `laravel-lang/json-fallback-hotfix`
+
+This package solves the problem of using JSON translations in applications where the fallback locale is not English.
+
+Out of the box, Laravel [doesn't allow](https://github.com/laravel/framework/issues/41565#issuecomment-1073572954)
+fallback translations for JSON keys.
+
+For example, when you call `__('Remember Me')`, you get `Remember Me` instead of `Se souvenir de moi` for French
+fallback language.
+
+This package solves this problem.

docs/installation/compatibility/common.md

@@ -4,12 +4,12 @@ title: Common
 
 # Compatibility: Common
 
-| Laravel, Lumen | PHP                | Package Version | What packages will be installed                              | Status                                |
-|----------------|--------------------|-----------------|--------------------------------------------------------------|---------------------------------------|
-| 10.x, 11.x     | 8.1, 8.2           | `^4.0`          | Publisher 14.x, Lang 13.x, Attributes 2.x, HTTP Statuses 3.x | ![Supported][badge_supported]         |
-| 8.x, 9.x, 10.x | 8.1, 8.2           | `^3.0`          | Publisher 14.x, Lang 12.x, Attributes 2.x, HTTP Statuses 3.x | ![Not Supported][badge_not_supported] |
-| 7.x, 8.x, 9.x  | 8.0, 8.1           | `^2.0`          | Publisher 13.x, Lang 10.x, Attributes 1.x, HTTP Statuses 2.x | ![Not Supported][badge_not_supported] |
-| 7.x, 8.x, 9.x  | 7.3, 7.4, 8.0, 8.1 | `^1.0`          | Publisher 12.x, Lang 10.x, Attributes 1.x, HTTP Statuses 2.x | ![Not Supported][badge_not_supported] |
+| Laravel, Lumen | PHP                | Package Version | What packages will be installed                                           | Status                                |
+|----------------|--------------------|-----------------|---------------------------------------------------------------------------|---------------------------------------|
+| 10.x, 11.x     | 8.1, 8.2           | `^4.0`          | Publisher 14.x, Lang 13.x, Attributes 2.x, HTTP Statuses 3.x, Locales 1.x | ![Supported][badge_supported]         |
+| 8.x, 9.x, 10.x | 8.1, 8.2           | `^3.0`          | Publisher 14.x, Lang 12.x, Attributes 2.x, HTTP Statuses 3.x              | ![Not Supported][badge_not_supported] |
+| 7.x, 8.x, 9.x  | 8.0, 8.1           | `^2.0`          | Publisher 13.x, Lang 10.x, Attributes 1.x, HTTP Statuses 2.x              | ![Not Supported][badge_not_supported] |
+| 7.x, 8.x, 9.x  | 7.3, 7.4, 8.0, 8.1 | `^1.0`          | Publisher 12.x, Lang 10.x, Attributes 1.x, HTTP Statuses 2.x              | ![Not Supported][badge_not_supported] |
 
 [badge_not_supported]:          https://img.shields.io/badge/not%20supported-lightgrey?style=flat-square
 

docs/installation/index.md

@@ -39,4 +39,6 @@ composer require --dev laravel-lang/publisher
 composer require --dev laravel-lang/lang
 composer require --dev laravel-lang/attributes
 composer require --dev laravel-lang/http-statuses
+
+composer require laravel-lang/locales
 ```