chore: update readme and some method comments

Author: inhere

README.md

@@ -24,7 +24,7 @@
 - 功能全面的命令行的选项、参数解析
   - 命名参数，数组参数
   - 选项绑定 短选项 `-s`，长选项 `--long`
-  - 支持定义数据类型(`bool,int,string,array`)，解析后会自动格式化输入值
+  - **NEW** v4 支持定义数据类型(`bool,int,string,array`)，解析后会自动格式化输入值
 - 命令方法注释自动解析为帮助信息
   - 默认提取 `@usage` `@arguments` `@options` `@example` 等信息
   - **NEW** v4 版本支持从注释定义选项参数的数据类型

src/Command.php

@@ -33,6 +33,11 @@ abstract class Command extends AbstractHandler implements CommandInterface
 {
     public const METHOD = 'execute';
 
+    /**
+     * @var Controller
+     */
+    protected $group;
+
     /**
      * @var Command
      */
@@ -130,4 +135,24 @@ public function getRealCName(): string
     {
         return self::getName();
     }
+
+    /**
+     * Get the group
+     *
+     * @return  Controller
+     */ 
+    public function getGroup()
+    {
+        return $this->group;
+    }
+
+    /**
+     * Set the value of group
+     *
+     * @param  Controller  $group
+     */ 
+    public function setGroup(Controller $group): void
+    {
+        $this->group = $group;
+    }
 }

src/Contract/RouterInterface.php

@@ -32,9 +32,9 @@ interface RouterInterface
      *
      * @param string                     $name    The controller name
      * @param string|ControllerInterface $class   The controller class
-     * @param array                      $options array:
-     *                                            - aliases     The command aliases
-     *                                            - description The description message
+     * @param array{aliases: array, desc: string} $options The options 
+     *                                            - aliases The command aliases
+     *                                            - desc    The description message
      *
      * @return static
      * @throws InvalidArgumentException
@@ -46,10 +46,9 @@ public function addGroup(string $name, $class = null, array $options = []): self
      *
      * @param string|CommandInterface         $name
      * @param string|Closure|CommandInterface $handler
-     * @param array                           $options
-     *  array:
-     *  - aliases     The command aliases
-     *  - description The description message
+     * @param array{aliases: array, desc: string} $options The options 
+     *                                            - aliases The command aliases
+     *                                            - desc    The description message
      *
      * @return static
      * @throws InvalidArgumentException

src/Controller.php

@@ -79,13 +79,6 @@ abstract class Controller extends AbstractHandler implements ControllerInterface
      */
     private $action = '';
 
-    /**
-     * The action method name on the controller.
-     *
-     * @var string
-     */
-    private $actionMethod = '';
-
     /**
      * The input group name.
      *
@@ -105,6 +98,13 @@ abstract class Controller extends AbstractHandler implements ControllerInterface
      */
     private $defaultAction = '';
 
+    /**
+     * The action method name on the controller.
+     *
+     * @var string
+     */
+    private $actionMethod = '';
+
     /**
      * @var string
      */
@@ -213,7 +213,7 @@ protected function disabledCommands(): array
      */
     protected function onNotFound(string $action, array $args): bool
     {
-        // you can add custom logic on sub-command not found.
+        // TIP: you can add custom logic on sub-command not found.
         return false;
     }