Merge branch 'main' into multi-select-options-closure

src/MultiSelectPrompt.php

@@ -51,6 +51,7 @@ public function __construct(
         public int $scroll = 5,
         public bool|string $required = false,
         public mixed $validate = null,
+        public bool $validateOnToggle = false, 
         public string $hint = '',
     ) {
         $this->options = $options instanceof Collection ? $options->all() : $options;
@@ -186,6 +187,9 @@ protected function toggleHighlighted(): void
         }
 
         $this->state = 'toggle';
+        if ($this->validateOnToggle) {
+            $this->validated = true;
+        }
     }
 
     /**

src/helpers.php

@@ -39,7 +39,7 @@ function select(string $label, array|Collection $options, int|string|null $defau
  * @param  array<int|string>|Collection<int, int|string>  $default
  * @return array<int|string>
  */
-function multiselect(string $label, array|Collection|Closure $options, array|Collection $default = [], int $scroll = 5, bool|string $required = false, mixed $validate = null, string $hint = 'Use the space bar to select options.'): array
+function multiselect(string $label, array|Collection|Closure $options, array|Collection $default = [], int $scroll = 5, bool|string $required = false, mixed $validate = null, bool $validateOnToggle = false, string $hint = 'Use the space bar to select options.'): array
 {
     return (new MultiSelectPrompt(...func_get_args()))->prompt();
 }

tests/Feature/MultiSelectPromptTest.php

@@ -160,6 +160,25 @@
     Prompt::assertOutputContains('You must select at least one color.');
 });
 
+it('can validate automatically upon toggling options', function () {
+    Prompt::fake([Key::DOWN, Key::SPACE, Key::SPACE, Key::UP, Key::SPACE, Key::ENTER]);
+
+    $result = multiselect(
+        label: 'What was the reason for the guard\'s retirement?',
+        options: [
+            'arrow' => 'He took an arrow in the knee',
+            'swordless' => 'He lost his sword',
+            'dragone' => 'He defeated all dragons',
+        ],
+        validate: fn ($values) => in_array('arrow', $values) ? null : 'Missing a joke!',
+        validateOnToggle: true,
+    );
+
+    expect($result)->toBe(['arrow']);
+
+    Prompt::assertOutputContains('Missing a joke!');
+});
+
 it('can fall back', function () {
     Prompt::fallbackWhen(true);