chore(console): throw on missing value

Signed-off-by: azjezz <azjezz@protonmail.com>

config/.phpcs.xml

@@ -8,7 +8,7 @@
     <!-- // START: Enums are not supported -->
     <exclude-pattern>*/src/Console/Output/(Type|Verbosity).php</exclude-pattern>
     <exclude-pattern>*/src/Console/Output/Sequence/Erase.php</exclude-pattern>
-    <exclude-pattern>*/src/Console/Output/Sequence/Erase.php</exclude-pattern>
+    <exclude-pattern>*/src/Console/Input/Definition/Mode.php</exclude-pattern>
     <exclude-pattern>*/src/Console/Internal/Utility.php</exclude-pattern>
     <exclude-pattern>*/src/Console/Command/ExitCode.php</exclude-pattern>
     <exclude-pattern>*/src/Console/Formatter/Style/(Effect|BackgroundColor|ForegroundColor).php</exclude-pattern>

src/Console/Input/Definition/Definition.php

@@ -5,6 +5,7 @@
 namespace Neu\Console\Input\Definition;
 
 use Psl\Str;
+use Neu\Console\Exception;
 
 /**
  * A `Definition` is an object that designates the parameters accepted by
@@ -71,7 +72,7 @@ public function getAlias(): string
      */
     public function alias(string $alias): self
     {
-        if (Str\length($alias) > Str\length($this->name)) {
+        if (Str\Byte\length($alias) > Str\Byte\length($this->name)) {
             $this->alias = $this->name;
             $this->name = $alias;
         } else {
@@ -94,7 +95,7 @@ public function getDescription(): string
      */
     public function getFormattedName(string $name): string
     {
-        if (Str\length($name) === 1) {
+        if (Str\Byte\length($name) === 1) {
             return '-' . $name;
         }
 
@@ -118,19 +119,19 @@ public function getName(): string
     }
 
     /**
-     * {@inheritDoc}
-     *
-     * @param T|null $default - The default value to return if no value has been assigned.
+     * Retrieve the value of the `Definition` as specified by the user.
      *
      * @return T
+     *
+     * @throws Exception\MissingValueException If the definition has not been assigned a value.
      */
-    public function getValue(mixed $default = null): mixed
+    public function getValue(): mixed
     {
         if ($this->exists) {
             return $this->value;
         }
 
-        return $default;
+        throw new Exception\MissingValueException(Str\format('The "%s" definition has not been assigned a value.', $this::class));
     }
 
     /**

src/Console/Input/Definition/DefinitionInterface.php

@@ -4,6 +4,8 @@
 
 namespace Neu\Console\Input\Definition;
 
+use Neu\Console\Exception;
+
 /**
  * An `DefinitionInterface` defines the name and type of input that may be accepted
  * by the user.
@@ -46,9 +48,9 @@ public function getName(): string;
     /**
      * Retrieve the value of the `DefinitionInterface` as specified by the user.
      *
-     * @param T|null $default - The default value to return if no value has been assigned.
-     *
      * @return T
+     *
+     * @throws Exception\MissingValueException If the definition has not been assigned a value.
      */
-    public function getValue(mixed $default = null): mixed;
+    public function getValue(): mixed;
 }

src/Console/Input/Definition/Mode.php

@@ -4,7 +4,8 @@
 
 namespace Neu\Console\Input\Definition;
 
-enum Mode: int {
-case Optional = 0;
-case Required = 1;
-    }
+enum Mode: int
+{
+    case Optional = 0;
+    case Required = 1;
+}