feat(helper): support grouped sorting for show help

Author: adhocore

src/Helper/OutputHelper.php

@@ -164,11 +164,16 @@ protected function showHelp(string $for, array $items, string $header = '', stri
         }
 
         $space = 4;
+        $group = $lastGroup = null;
         foreach ($this->sortItems($items, $padLen) as $item) {
-            $name = $this->getName($item);
-            $desc = \str_replace(["\r\n", "\n"], \str_pad("\n", $padLen + $space + 3), $item->desc());
+            $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());
 
-            $this->writer->bold('  ' . \str_pad($name, $padLen + $space));
+            $this->writer->bold('  ' . str_pad($name, $padLen + $space));
             $this->writer->comment($desc, true);
         }
 
@@ -239,9 +244,14 @@ public function showCommandNotFound(string $attempted, array $available): self
      */
     protected function sortItems(array $items, &$max = 0): array
     {
-        $max = \max(\array_map(fn ($item) => \strlen($this->getName($item)), $items));
+        $max = max(array_map(fn ($item) => strlen($this->getName($item)), $items));
+
+        uasort($items, static function ($a, $b) {
+            $aName = $a instanceof Groupable ? $a->group() . $a->name() : $a->name();
+            $bName = $b instanceof Groupable ? $b->group() . $b->name() : $b->name();
 
-        \uasort($items, fn ($a, $b) => $a->name() <=> $b->name());
+            return $aName <=> $bName;
+        });
 
         return $items;
     }