Merge branch 'develop'

Author: danielRConsid

Ansi.php

@@ -2,6 +2,7 @@
 
 namespace MaplePHP\Prompts;
 
+use Exception;
 use InvalidArgumentException;
 
 /**
@@ -143,52 +144,72 @@ public function clearDown(): string
 
     /**
      * Clear line
-     * 
+     *
      * @return string
+     * @throws Exception
      */
     public function clearLine(): string
     {
+        if (!self::isSupported()) {
+            throw new Exception("Ansi not supported by OS", 1);
+        }
         return "\033[2K";
     }
 
     /**
      * Move cursor to specified line
-     * 
+     *
      * @param int $line
      * @return string
+     * @throws Exception
      */
     public function moveCursorTo(int $line): string
     {
+        if (!self::isSupported()) {
+            throw new Exception("Ansi not supported by OS", 1);
+        }
         return "\033[{$line}A";
     }
 
     /**
      * Move cursor down
-     * 
+     *
      * @return string
+     * @throws Exception
      */
     public function cursorDown(): string
     {
+        if (!self::isSupported()) {
+            throw new Exception("Ansi not supported by OS", 1);
+        }
         return "\033[1B";
     }
 
     /**
      * Arrow up key
-     * 
+     *
      * @return string
+     * @throws Exception
      */
     public function keyUp(): string 
     {
+        if (!self::isSupported()) {
+            throw new Exception("Ansi not supported by OS", 1);
+        }
         return "\033[A";
     }
 
     /**
      * Arrow down key
-     * 
+     *
      * @return string
+     * @throws Exception
      */
     public function keyDown(): string 
     {
+        if (!self::isSupported()) {
+            throw new Exception("Ansi not supported by OS", 1);
+        }
         return "\033[B";
     }
 
@@ -204,21 +225,29 @@ public function keyEnter(): string
 
     /**
      * Escape key
-     * 
+     *
      * @return string
+     * @throws Exception
      */
     public function keyEscape(): string 
     {
+        if (!self::isSupported()) {
+            throw new Exception("Ansi not supported by OS", 1);
+        }
         return "\033";
     }
 
     /**
      * Symbol: checkbox
-     * 
+     *
      * @return string
+     * @throws Exception
      */
     public function checkbox(): string 
     {
+        if (!self::isSupported()) {
+            throw new Exception("Ansi not supported by OS", 1);
+        }
         return "\xE2\x9C\x94";
     }
 
@@ -232,11 +261,15 @@ final public static function isSupported(): bool
     {
         if (is_null(self::$hasAnsi)) {
             if (stripos(PHP_OS, 'WIN') === 0) {
+
+                self::$hasAnsi = false;
+                /*
                 $osVersion = php_uname('v');
                 if (preg_match('/build (\d+)/i', $osVersion, $matches)) {
                     $buildNumber = (int)$matches[1];
                     self::$hasAnsi = ($buildNumber >= 10586);
                 }
+                 */
             } else {
                 self::$hasAnsi = (getenv('TERM') && str_contains(getenv('TERM'), 'xterm'));
             }

Command.php

@@ -20,7 +20,7 @@ class Command
 
     public function __construct()
     {
-        $this->stream = new Stream(Stream::STDIN, "r");
+        $this->stream = new Stream(Stream::STDOUT);
         $this->stty = new SttyWrapper();
         $this->ansi = new Ansi();
     }

README.md

@@ -1,9 +1,11 @@
 # MaplePHP Prompts
 
-PHP Prompts is an interactive, lightweight, and easy-to-use CLI (Command Line Interface) PHP library. It provides a way to create and manage user prompts in a command-line environment, enabling the collection of various types of user input with validation and feedback.
+PHP Prompts is a pretty, interactive, lightweight, and user-friendly CLI (Command Line Interface) PHP library designed for seamless use across Linux, Unix, Darwin, and Windows. It allows you to create and manage user prompts in a command-line environment, enabling the collection of various types of input with built-in validation and feedback.
 
 ![Prompt demo](http://wazabii.se/github-assets/maplephp-prompt-v2.gif)
 
+_Note that the prompt may not look as polished on Windows as on Unix, but it will work just as well._
+
 ### Table of Contents
 - [Installation](#installation)
 - [Usage Example](#usage-example)

composer.json

@@ -1,15 +1,20 @@
 {
   "name": "maplephp/prompts",
   "type": "library",
-  "version": "v1.0.3",
-  "description": "PHP Prompts is an interactive, lightweight and very easy to CLI (Command Line Interface) PHP library.",
+  "version": "v1.0.4",
+  "description": "PHP Prompts is a pretty, interactive, lightweight, and user-friendly CLI (Command Line Interface) PHP library designed for seamless use across Linux, Unix, Darwin, and Windows.",
   "keywords": [
     "php",
     "cli",
     "command line",
     "prompt",
     "lightweight",
-    "cross-platform"
+    "cross-platform",
+    "cross-os",
+    "Linux",
+    "Unix",
+    "Darwin",
+    "windows"
   ],
   "homepage": "https://wazabii.se",
   "license": "Apache-2.0",