feat: show defaults for options/arguments

Author: adhocore

src/Helper/OutputHelper.php

@@ -195,13 +195,14 @@ protected function showHelp(string $for, array $items, string $header = '', stri
 
         $space = 4;
         $group = $lastGroup = null;
+        $withDefault = $for === 'Options' || $for === 'Arguments';
         foreach ($this->sortItems($items, $padLen) as $item) {
             $name  = $this->getName($item);
             if ($for === 'Commands' && $lastGroup !== $group = $item->group()) {
                 $this->writer->boldYellow($group ?: '*', true);
                 $lastGroup = $group;
             }
-            $desc  = str_replace(["\r\n", "\n"], str_pad("\n", $padLen + $space + 3), $item->desc());
+            $desc  = str_replace(["\r\n", "\n"], str_pad("\n", $padLen + $space + 3), $item->desc($withDefault));
 
             $this->writer->bold('  ' . str_pad($name, $padLen + $space));
             $this->writer->comment($desc, true);

src/Input/Parameter.php

@@ -13,7 +13,10 @@
 
 use Ahc\Cli\Helper\InflectsString;
 
+use function json_encode;
+use function ltrim;
 use function strpos;
+use function sprintf;
 
 /**
  * Cli Parameter.
@@ -75,9 +78,13 @@ public function name(): string
     /**
      * Get description.
      */
-    public function desc(): string
+    public function desc(bool $withDefault = false): string
     {
-        return $this->desc;
+        if (!$withDefault || null === $this->default || '' === $this->default) {
+            return $this->desc;
+        }
+
+        return ltrim(sprintf('%s [default: %s]', $this->desc, json_encode($this->default)));
     }
 
     /**