add more setting for flags parse

Author: inhere

src/Flag/Flags.php

@@ -91,7 +91,7 @@ public function parse(array $args = null): array
         }
 
         $this->parsed  = true;
-        $this->rawArgs = $this->args = $args;
+        $this->rawFlags = $this->args = $args;
 
         while (true) {
             [$goon, $status] = $this->parseOne();

src/Flag/SFlags.php

@@ -28,18 +28,73 @@ class SFlags extends AbstractObj
         // List of option allow array values.
         'arrayOpts'      => [], // ['names', 'status']
         // Special short style
-        // posix: -abc will expand: -a -b -c
-        // unix: -abc  will expand: -a=bc
-        'shortStyle' => 'posix',
+        // gnu: `-abc` will expand: `-a -b -c`
+        // posix: `-abc`  will expand: `-a=bc`
+        'shortStyle'     => 'posix',
     ];
 
     /**
+     * Special short style
+     *  gnu: `-abc` will expand: `-a -b -c`
+     *  posix: `-abc`  will expand: `-a=bc`
+     *
+     * @var string
+     */
+    private $shortStyle = 'posix';
+
+    /**
+     * Whether stop parse option on found unknown option
+     *
+     * @var bool
+     */
+    private $stopOnUnknown = true;
+
+    /**
+     * Whether parse the remaining args {@see $rawArgs}.
+     *
+     * eg: 'arg=value' -> [arg => value]
+     *
+     * @var bool
+     */
+    private $parseRawArgs = true;
+
+    /**
+     * Parsed options
+     *
+     * @var array
+     */
+    private $opts = [];
+
+    /**
+     * Parsed arguments
+     *
+     * @var array
+     */
+    private $args = [];
+
+    /**
+     * Parse options by pre-defined
+     *
+     * ```php
+     * // element format:
+     * // - k-v: k is option, v is value type
+     * // - v:  v is option, type is string.
+     * $defines = [
+     *  's,long', // use default type: string
+     *  // option => value type,
+     *  's,long' => string,
+     *  's'      => bool,
+     *  'long'   => int,
+     *  'long'   => array, // TODO int[], string[]
+     * ];
+     * ```
+     *
      * @param array $rawArgs
-     * @param array $settings
+     * @param array $defines
      *
      * @return array
      */
-    public function parse(array $rawArgs, array $settings = []): array
+    public function parseDefined(array $rawArgs, array $defines, array $settings = []): array
     {
         $this->setSettings($settings);
     }

src/Flag/Traits/FlagParsingTrait.php

@@ -23,33 +23,34 @@ trait FlagParsingTrait
     private $stopOnArg = true;
 
     /**
-     * The remaining args on option parsed
+     * The raw input flags
      *
      * @var array
      */
-    private $args = [];
+    protected $rawFlags = [];
 
     /**
-     * The raw input args
+     * The remaining args.
+     * After on option parsed from {@see $rawFlags}
      *
      * @var array
      */
-    private $rawArgs = [];
+    protected $rawArgs = [];
 
     /**
      * @return array
      */
-    public function getArgs(): array
+    public function getRawArgs(): array
     {
-        return $this->args;
+        return $this->rawArgs;
     }
 
     /**
      * @return array
      */
-    public function getRawArgs(): array
+    public function getRawFlags(): array
     {
-        return $this->rawArgs;
+        return $this->rawFlags;
     }
 
     /**