Release version 2.0.1

Author: phpdevcommunity

README.md

@@ -131,6 +131,48 @@ The `resolve()` method throws an `InvalidArgumentException` if:
 *   An undefined option is provided.
 *   An option value is invalid (wrong type or failed custom validation).
 
+### Conditional Requirements
+
+You can make an option required only if another option has a specific value using `addRequiredIf`.
+
+```php
+$resolver = new OptionsResolver([
+    Option::bool('has_database')->setOptional(false),
+    Option::string('db_host')->setOptional(null),
+]);
+
+// 'db_host' becomes required only if 'has_database' is true
+$resolver->addRequiredIf('db_host', 'has_database', true);
+```
+
+### Deprecating Options
+
+You can mark an option as deprecated. A `E_USER_DEPRECATED` error will be triggered if the option is used.
+
+```php
+Option::string('old_option')->deprecate('Use "new_option" instead.');
+```
+
+### Additional Constraints
+
+The library provides helpers for common constraints like `min` and `max`. These work for strings (length), numbers (value), and arrays (count).
+
+```php
+Option::string('username')->min(3)->max(20);
+Option::int('age')->min(18);
+Option::array('tags')->max(5);
+```
+
+### Multiple Validators
+
+You can chain multiple validators. All of them must pass.
+
+```php
+Option::string('code')
+    ->validator(fn($v) => str_starts_with($v, 'A'))
+    ->validator(fn($v) => str_ends_with($v, 'Z'));
+```
+
 ### License
 
 This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
@@ -250,6 +292,48 @@ La méthode `resolve()` lance une `InvalidArgumentException` si :
 *   Une option non définie est fournie.
 *   Une valeur d'option est invalide (mauvais type ou échec de validation personnalisée).
 
+### Prérequis Conditionnels
+
+Vous pouvez rendre une option obligatoire uniquement si une autre option a une valeur spécifique en utilisant `addRequiredIf`.
+
+```php
+$resolver = new OptionsResolver([
+    Option::bool('has_database')->setOptional(false),
+    Option::string('db_host')->setOptional(null),
+]);
+
+// 'db_host' devient requis uniquement si 'has_database' est true
+$resolver->addRequiredIf('db_host', 'has_database', true);
+```
+
+### Obsolescence (Deprecation)
+
+Vous pouvez marquer une option comme obsolète. Une erreur `E_USER_DEPRECATED` sera déclenchée si l'option est utilisée.
+
+```php
+Option::string('old_option')->deprecate('Utilisez "new_option" à la place.');
+```
+
+### Contraintes Supplémentaires
+
+La bibliothèque fournit des aides pour des contraintes courantes comme `min` et `max`. Elles fonctionnent pour les chaînes (longueur), les nombres (valeur) et les tableaux (nombre d'éléments).
+
+```php
+Option::string('username')->min(3)->max(20);
+Option::int('age')->min(18);
+Option::array('tags')->max(5);
+```
+
+### Validateurs Multiples
+
+Vous pouvez enchaîner plusieurs validateurs. Tous doivent être valides.
+
+```php
+Option::string('code')
+    ->validator(fn($v) => str_starts_with($v, 'A'))
+    ->validator(fn($v) => str_ends_with($v, 'Z'));
+```
+
 ### Licence
 
 Ce projet est sous licence MIT. Voir le fichier [LICENSE](LICENSE) pour plus de détails.

composer.json

@@ -1,12 +1,12 @@
 {
     "name": "phpdevcommunity/php-options-resolver",
-    "description": "This library provides a simple solution for processing and validating option arrays in PHP.",
+    "description": "Strict, Fluent, and Type-Safe Option Validation for PHP.",
     "type": "library",
     "license": "MIT",
     "authors": [
         {
             "name": "F. Michel",
-            "homepage": "https://www.phpdevcommunity.com"
+            "homepage": "https://www.depohub.org"
         }
     ],
     "autoload": {
@@ -16,7 +16,8 @@
         }
     },
     "require": {
-        "php": ">=7.4"
+        "php": ">=7.4",
+        "ext-mbstring": "*"
     },
     "require-dev": {
         "depo/unitester": "^1.0.0"