[Feat] Command Prompt Inputs (#123)

* feat: console prompt input

* fix: default callback and return type

* fix phpstan

* formatting

Author: SonyPradana

src/System/Console/Prompt.php

@@ -0,0 +1,119 @@
+<?php
+
+declare(strict_types=1);
+
+namespace System\Console;
+
+use System\Console\Style\Style;
+
+/**
+ * Add costumize terminal style by adding trits:
+ * - TraitCommand (optional).
+ *
+ * @property string $_ Get argument name
+ */
+class Prompt
+{
+    /**
+     * @var string|Style
+     */
+    private $title;
+
+    /**
+     * @var array<string, callable>
+     */
+    private array $options;
+
+    private string $default;
+
+    /**
+     * @var string[]|Style[]
+     */
+    private array $selection;
+
+    /**
+     * @param string|Style            $title
+     * @param array<string, callable> $options
+     */
+    public function __construct($title, array $options = [], string $default = '')
+    {
+        $this->title     = $title;
+        $this->options   = array_merge(['' => fn () => false], $options);
+        $this->default   = $default;
+        $this->selection = array_keys($options);
+    }
+
+    private function getInput(): string
+    {
+        $input = fgets(STDIN);
+
+        if ($input === false) {
+            throw new \Exception('Cant read input');
+        }
+
+        return trim($input);
+    }
+
+    /**
+     * @param string[]|Style[] $selection
+     */
+    public function selection($selection): self
+    {
+        $this->selection = $selection;
+
+        return $this;
+    }
+
+    public function option(): mixed
+    {
+        $style = new Style();
+        $style->push($this->title)->push(' ');
+        foreach ($this->selection as $option) {
+            if ($option instanceof Style) {
+                $style->tap($option);
+            } else {
+                $style->push("{$option} ");
+            }
+        }
+
+        $style->out();
+        $input = $this->getInput();
+        if (array_key_exists($input, $this->options)) {
+            return ($this->options[$input])();
+        }
+
+        return ($this->options[$this->default])();
+    }
+
+    public function select(): mixed
+    {
+        $style = new Style();
+        $style->push($this->title);
+        $i = 0;
+        foreach ($this->selection as $option) {
+            if ($option instanceof Style) {
+                $style->tap($option);
+            } else {
+                $style->new_lines()->push("> {$i} {$option}");
+            }
+            $i++;
+        }
+
+        $style->out();
+        $input  = $this->getInput();
+        $select = array_values($this->options);
+
+        if (array_key_exists($input, $select)) {
+            return ($select[$input])();
+        }
+
+        return ($this->options[$this->default])();
+    }
+
+    public function text(callable $callable): mixed
+    {
+        (new Style($this->title))->out();
+
+        return ($callable)($this->getInput());
+    }
+}

src/System/Console/helper.php

@@ -4,6 +4,8 @@
 
 namespace System\Console;
 
+use System\Console\Style\Style;
+
 if (!function_exists('style')) {
     /**
      * Render text with terminal style (chain way).
@@ -73,3 +75,41 @@ function ok($text)
         return \System\Console\Style\Alert::render()->ok($text);
     }
 }
+
+if (!function_exists('option')) {
+    /**
+     * Command Prompt input option.
+     *
+     * @param string|Style            $title
+     * @param array<string, callable> $options
+     */
+    function option($title, array $options): mixed
+    {
+        return (new Prompt($title, $options))->option();
+    }
+}
+
+if (!function_exists('select')) {
+    /**
+     * Command Prompt input selection.
+     *
+     * @param string|Style            $title
+     * @param array<string, callable> $options
+     */
+    function select($title, array $options): mixed
+    {
+        return (new Prompt($title, $options))->select();
+    }
+}
+
+if (!function_exists('text')) {
+    /**
+     * Command Prompt input text.
+     *
+     * @param string|Style $title
+     */
+    function text($title, callable $callable): mixed
+    {
+        return (new Prompt($title))->text($callable);
+    }
+}