chore: use named parameters in samples

Author: domthomas-dev

README.md

@@ -93,7 +93,7 @@ $contact->type = ContactType::EMAIL;
 echo $contact->type->label(); // "Email"
 
 // Get label in specific locale
-echo $contact->type->label(null, 'fr'); // "E-mail"
+echo $contact->type->label(locale: 'fr'); // "E-mail"
 ```
 
 ### Multiple Label Types
@@ -118,22 +118,27 @@ $options = ContactType::forSelect();
 // Returns: ['email' => 'Email', 'phone' => 'Phone', 'sms' => 'SMS']
 
 // With placeholder
-$options = ContactType::forSelect(null, null, 'Choose contact type');
-// Returns: ['' => 'Choose contact type', 'email' => 'Email', ...]
+$options = ContactType::forSelect(placeHolder: 'Choose contact type');
+// Returns: ['' => 'Choose contact type', 'email' => 'Email', 'phone' => 'Phone', 'sms' => 'SMS']
 
 // With specific label type
-$options = ContactType::forSelect('description');
+$options = ContactType::forSelect(label: 'description');
+// Returns: ['email' => 'Send via email', 'phone' => 'Call by phone', 'sms' => 'Send text message']
 
 // With specific locale
-$options = ContactType::forSelect(null, 'fr');
+$options = ContactType::forSelect(locale: 'fr');
+// Returns: ['email' => 'E-mail', 'phone' => 'Téléphone', 'sms' => 'SMS']
 
 // Exclude specific cases
-$options = ContactType::forSelect(null, null, null, [ContactType::SMS]);
+$options = ContactType::forSelect(excepted: [ContactType::SMS]);
 // Returns only EMAIL and PHONE options
+// Returns: ['email' => 'Email', 'phone' => 'Phone']
 
 // Include only specific cases
-$options = ContactType::forSelect(null, null, null, null, [ContactType::EMAIL, ContactType::PHONE]);
+$options = ContactType::forSelect(only: [ContactType::EMAIL, ContactType::PHONE]);
 // Returns only EMAIL and PHONE options
+// Returns: ['email' => 'Email', 'phone' => 'Phone']
+
 
 // Get structured options array
 $options = ContactType::options();
@@ -142,21 +147,24 @@ $options = ContactType::options();
 //     ['value' => 'phone', 'label' => 'Phone'],
 //     ['value' => 'sms', 'label' => 'SMS']
 // ]
+
+// With custom label and locale
+$options = ContactType::options(label: 'description', locale: 'fr');
 ```
 
 ### Blade Usage
 
 ```blade
 <!-- In a select input -->
 <select name="contact_type">
-    @foreach(ContactType::forSelect(null, null, 'Select type') as $value => $label)
+    @foreach(ContactType::forSelect(placeHolder: 'Select type') as $value => $label)
         <option value="{{ $value }}">{{ $label }}</option>
     @endforeach
 </select>
 
 <!-- Select with filtered options -->
 <select name="preferred_contact">
-    @foreach(ContactType::forSelect(null, null, 'Choose method', [ContactType::SMS]) as $value => $label)
+    @foreach(ContactType::forSelect(placeHolder: 'Choose method', excepted: [ContactType::SMS]) as $value => $label)
         <option value="{{ $value }}">{{ $label }}</option>
     @endforeach
 </select>
@@ -186,8 +194,8 @@ $values = ContactType::values();
 // Returns: ['email', 'phone', 'sms']
 
 // Filter enum cases
-$filtered = ContactType::filterCases([ContactType::SMS]); // Exclude SMS
-$onlyEmailPhone = ContactType::filterCases(null, [ContactType::EMAIL, ContactType::PHONE]); // Only EMAIL and PHONE
+$filtered = ContactType::filterCases(excepted: [ContactType::SMS]); // Exclude SMS
+$onlyEmailPhone = ContactType::filterCases(only: [ContactType::EMAIL, ContactType::PHONE]); // Only EMAIL and PHONE
 ```
 
 ## Advanced Features