chore: update some method comments

Author: inhere

Diff for: .php_cs renamed to .php-cs-fixer.php

@@ -3,18 +3,21 @@
 $header = <<<'EOF'
 This file is part of toolkit/cli-utils.
 
-@homepage https://github.com/php-toolkit/cli-utils
+@link     https://github.com/php-toolkit/cli-utils
 @author   https://github.com/inhere
 @license  MIT
 EOF;
 
-return (new PhpCsFixer\Config)
+return (new PhpCsFixer\Config())
     ->setRiskyAllowed(true)
     ->setRules([
         '@PSR2' => true,
         'array_syntax' => [
             'syntax' => 'short'
         ],
+        'list_syntax' => [
+            'syntax' => 'short'
+        ],
         'class_attributes_separation' => true,
         'declare_strict_types' => true,
         'global_namespace_import' => [
@@ -29,11 +32,13 @@
         'no_unused_imports' => true,
         'single_quote' => true,
         'standardize_not_equals' => true,
+        'void_return' => true, // add :void for method
     ])
     ->setFinder(
         PhpCsFixer\Finder::create()
-            // ->exclude('test')
+            ->exclude('test')
             ->exclude('runtime')
+            ->exclude('.github')
             ->exclude('vendor')
             ->in(__DIR__)
     )

Diff for: src/Cli.php

@@ -94,7 +94,7 @@ public static function __callStatic(string $method, array $args)
      */
     public static function colored(array|string $message, array|string $style = 'info'): void
     {
-        $str = is_array($message) ? implode(' ', $message) : (string)$message;
+        $str = is_array($message) ? implode(' ', $message) : $message;
 
         echo Color::render($str, $style) . PHP_EOL;
     }
@@ -134,16 +134,20 @@ public static function color(string $text, array|string $style = null): string
     /**
      * print log to console
      *
-     * @param string $msg
-     * @param array  $data
-     * @param string $type
-     * @param array{writeOpts:array} $labels
+     * ```php
      *  [
      *  '_category' => 'application',
      *  'process' => 'work',
      *  'pid' => 234,
      *  'coId' => 12,
      *  ]
+     * ```
+     *
+     * @param string $msg
+     * @param array  $data
+     * @param string $type
+     * @param array{writeOpts:array} $labels
+     * @deprecated please use Clog::info();
      */
     public static function clog(string $msg, array $data = [], string $type = 'info', array $labels = []): void
     {

Diff for: src/Helper/CliHelper.php

@@ -3,7 +3,6 @@
 namespace Toolkit\Cli\Helper;
 
 use function escapeshellarg;
-use function explode;
 use function is_bool;
 use function is_numeric;
 use function preg_match;
@@ -64,42 +63,6 @@ public static function filterBool(mixed $val): mixed
         return $val;
     }
 
-    /**
-     * check input is valid option value
-     *
-     * @param mixed $val
-     *
-     * @return bool
-     */
-    public static function isOptionValue(mixed $val): bool
-    {
-        if ($val === false) {
-            return false;
-        }
-
-        // if is: '', 0
-        if (!$val) {
-            return true;
-        }
-
-        // is not option name.
-        if ($val[0] !== '-') {
-            // ensure is option value.
-            if (!str_contains($val, '=')) {
-                return true;
-            }
-
-            // is string value, but contains '='
-            [$name,] = explode('=', $val, 2);
-
-            // named argument OR invalid: 'some = string'
-            return false === self::isValidName($name);
-        }
-
-        // is option name.
-        return false;
-    }
-
     /**
      * @param string $name
      *