refactor(WithRunable): Update callable types to Closure for better type safety

- Change callable type hints to Closure for $pipe and $tap properties.
- Update method signatures for withPipe and withTap to accept Closure.
- Ensure type checks use instanceof for Closure instead of is_callable.

Signed-off-by: guanguans <ityaozm@gmail.com>

Author: guanguans

README.md

@@ -514,7 +514,7 @@ $soar->withSudoPassword('your sudo password'); // With a sudo password to run th
 
 ### Or configure sudoers
 
-> On higher versions of macOS, it is possible that the fingerprint authentication window will pop up. You can configure sudoers to run `soar` commands without a password.
+> On higher versions of macOS, it is possible that the fingerprint authentication window will pop up. You can configure sudoers to run `soar` command without password.
 
 1. Edit Configuration file of sudoers:
 
@@ -534,8 +534,8 @@ guanguans ALL=(ALL) NOPASSWD: /Users/guanguans/Documents/develop/soar-php/bin/so
 ```shell
 composer benchmark
 composer checks:required
-composer soar:example-run
-composer soar:example-serve
+composer soar:usage-example-run
+composer soar:usage-example-serve
 composer test
 ```
 

composer-bump

@@ -213,7 +213,7 @@ class ComposerBump
                     },
                 ];
 
-                sort($dependencyVersions);
+                sort($dependencyVersions, \SORT_NUMERIC);
 
                 $package['dependency_version'] = implode(' || ', $dependencyVersions);
                 $carry[$package['name']] = $package;

composer.json

@@ -214,6 +214,7 @@
             "@php-cs-fixer:fix-dry-run-stop-on-violation",
             "@soar:check-binary",
             "@soar:dump-config",
+            "@soar:usage-example-run",
             "@pest:bail",
             "@rector:process-dry-run",
             "@phpstan:analyse"
@@ -394,7 +395,7 @@
         "rule-doc-generator:rector-validate": "@rule-doc-generator validate src/Support/Rectors/",
         "sk": "@php vendor/bin/swiss-knife --ansi -vv",
         "sk:alice-yaml-fixtures-to-php": "@sk alice-yaml-fixtures-to-php --help",
-        "sk:check-commented-code": "@sk check-commented-code examples/ src/ --line-limit=5 --skip-file=src/Soar.php",
+        "sk:check-commented-code": "@sk check-commented-code examples/ src/ --line-limit=6 --skip-file=src/Soar.php",
         "sk:check-conflicts": "@sk check-conflicts examples/ src/",
         "sk:dump-editorconfig": "@sk dump-editorconfig",
         "sk:finalize-classes": "@sk finalize-classes examples/ src/",
@@ -428,13 +429,13 @@
         ],
         "soar:dump-php-config-prototype": "Guanguans\\SoarPHP\\Support\\ComposerScripts::dumpSoarPHPConfig",
         "soar:dump-yaml-config": "Guanguans\\SoarPHP\\Support\\ComposerScripts::dumpSoarYamlConfig",
-        "soar:example-run": [
+        "soar:usage-example-run": [
             "echo 'examples/example.php:\n'",
-            "@php examples/example.php"
+            "@php examples/usage-example.php"
         ],
-        "soar:example-serve": [
+        "soar:usage-example-serve": [
             "@composer-config:disable-process-timeout",
-            "@php -S localhost:8123 examples/example.php"
+            "@php -S localhost:8123 examples/usage-example.php"
         ],
         "testbench": "@php vendor/bin/testbench --ansi",
         "testbench:build": "@testbench workbench:build",

examples/example.php examples/usage-example.phpexamples/example.php renamed to examples/usage-example.php

@@ -20,20 +20,20 @@
  */
 trait WithRunable
 {
-    /** @var null|callable(Process): Process */
-    protected $pipe;
+    /** @var null|\Closure(Process): Process */
+    protected ?\Closure $pipe = null;
 
-    /** @var null|callable(Process): void */
-    protected $tap;
+    /** @var null|\Closure(Process): void */
+    protected ?\Closure $tap = null;
 
-    public function withPipe(?callable $pipe): self
+    public function withPipe(?\Closure $pipe): self
     {
         $this->pipe = $pipe;
 
         return $this;
     }
 
-    public function withTap(?callable $tap): self
+    public function withTap(?\Closure $tap): self
     {
         $this->tap = $tap;
 
@@ -59,10 +59,10 @@ protected function toProcess(): Process
             ? new Process(command: ['sudo', '-S', ...$command], input: $this->getSudoPassword())
             : new Process($command);
 
-        if (\is_callable($this->tap)) {
-            ($this->tap)($process);
+        if ($this->tap instanceof \Closure) {
+            $this->tap->call($process, $process);
         }
 
-        return \is_callable($this->pipe) ? ($this->pipe)($process) : $process;
+        return $this->pipe instanceof \Closure ? ($this->pipe)->call($process, $process) : $process;
     }
 }

src/Concerns/WithRunable.php

@@ -62,7 +62,12 @@ protected function shouldApplySudoPassword(): bool
 it('can run soar process with pipe', function (): void {
     expect(Soar::make())
         ->withVersion(true)
-        ->withPipe(static fn (Process $process): Process => $process->setTimeout(3))
+        ->withPipe(function (Process $process): Process {
+            expect($this)->toBeInstanceOf(Process::class);
+            expect($this->commandline)->toBeArray();
+
+            return $process->setTimeout(3);
+        })
         ->run(static function (string $type, string $line): void {
             // dump($type, $line);
         })
@@ -72,7 +77,10 @@ protected function shouldApplySudoPassword(): bool
 it('can run soar process with tap', function (): void {
     expect(Soar::make())
         ->withVersion(true)
-        ->withTap(static function (Process $process): void {
+        ->withTap(function (Process $process): void {
+            expect($this)->toBeInstanceOf(Process::class);
+            expect($this->commandline)->toBeArray();
+
             $process->setTimeout(3);
         })
         ->run(static function (string $type, string $line): void {