Split phpstan configs to separate packages

Author: SerafimArts

phpstan.neon

@@ -0,0 +1,22 @@
+parameters:
+  level: max
+  scanFiles:
+    - resources/stubs/aliases.stub.php
+    - resources/stubs/saucer-webview-events.stub.php
+    - resources/stubs/saucer-window-events.stub.php
+    - resources/stubs/kernel32.stub.php
+    - resources/stubs/user32.stub.php
+  excludePaths:
+    - src/Api/Console/Driver/Windows/Kernel32.php
+    - src/Api/MessageBox/Driver/Windows/User32.php
+  strictRules:
+    allRules: true
+  fileExtensions:
+    - php
+  paths:
+    - src
+  tmpDir: vendor/.cache.phpstan
+  ignoreErrors:
+    # PHPStan does not support FFI
+    - '#^Access to an undefined property FFI\\CData#'
+    - '#does not accept FFI\\CData#'

resources/stubs/kernel32.stub.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Boson\Api\DetachConsole\Driver\Windows;
+namespace Boson\Api\Console\Driver\Windows;
 
 use FFI\CData;
 use FFI\CType;

src/Api/Autorun/AutorunExtensionProvider.php

@@ -4,6 +4,7 @@
 
 namespace Boson\Api\Autorun;
 
+use Boson\Api\Autorun\Event\ExpectsAutorun;
 use Boson\Application;
 use Boson\ApplicationCreateInfo;
 use Boson\Contracts\EventListener\Subscription\CancellableSubscriptionInterface;
@@ -44,8 +45,8 @@ public function load(IdentifiableInterface $ctx, EventListener $listener): null
 
         $this->listenStartup($ctx, $listener);
 
-        $callback = function () use ($ctx): void {
-            $this->onApplicationShouldStart($ctx);
+        $callback = function () use ($ctx, $listener): void {
+            $this->onApplicationShouldStart($ctx, $listener);
         };
 
         foreach ($this->info->handlers as $handler) {
@@ -85,14 +86,20 @@ private function onApplicationStarted(ApplicationStarted $event): void
      * A callback that is called when the application WANTS to start (using
      * autorun features).
      */
-    private function onApplicationShouldStart(Application $app): void
+    private function onApplicationShouldStart(Application $app, EventListener $listener): void
     {
         if (!$this->shouldStart($app)) {
             return;
         }
 
         $this->shouldNotRunAnymore($app);
 
+        $listener->dispatch($intention = new ExpectsAutorun($app));
+
+        if ($intention->isCancelled) {
+            return;
+        }
+
         $app->run();
     }
 

src/Api/Autorun/Event/AutorunIntention.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\Autorun\Event;
+
+use Boson\Event\ApplicationApiIntention;
+
+abstract class AutorunIntention extends ApplicationApiIntention {}

src/Api/Autorun/Event/ExpectsAutorun.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\Autorun\Event;
+
+use Boson\Shared\Marker\AsApplicationEvent;
+
+#[AsApplicationEvent]
+final class ExpectsAutorun extends AutorunIntention {}

…nsole/DetachConsoleExtensionProvider.php …Api/Console/ConsoleExtensionProvider.phpsrc/Api/DetachConsole/DetachConsoleExtensionProvider.php renamed to src/Api/Console/ConsoleExtensionProvider.php src/Api/DetachConsole/DetachConsoleExtensionProvider.php renamed to src/Api/Console/ConsoleExtensionProvider.php

@@ -2,10 +2,12 @@
 
 declare(strict_types=1);
 
-namespace Boson\Api\DetachConsole;
+namespace Boson\Api\Console;
 
-use Boson\Api\DetachConsole\Driver\DetachConsoleDriverInterface;
-use Boson\Api\DetachConsole\Driver\WindowsDetachConsoleDriver;
+use Boson\Api\Console\Driver\ConsoleDriverInterface;
+use Boson\Api\Console\Driver\WindowsConsoleDriver;
+use Boson\Api\Console\Event\ConsoleDetached;
+use Boson\Api\Console\Event\ConsoleDetaching;
 use Boson\Api\OperatingSystem\OperatingSystemExtensionInterface;
 use Boson\Api\OperatingSystem\OperatingSystemExtensionProvider;
 use Boson\Application;
@@ -20,7 +22,7 @@
  * @template-extends ExtensionProvider<Application>
  */
 #[DependsOn(OperatingSystemExtensionProvider::class)]
-final class DetachConsoleExtensionProvider extends ExtensionProvider
+final class ConsoleExtensionProvider extends ExtensionProvider
 {
     public function load(IdentifiableInterface $ctx, EventListener $listener): null
     {
@@ -29,21 +31,29 @@ public function load(IdentifiableInterface $ctx, EventListener $listener): null
         // Detach console in case of:
         // 1) Debug mode is disabled
         // 2) And application running in PHAR
-        if ($ctx->isDebug && $this->isRunningInPhar()) {
-            $driver?->detach();
+        if ($driver !== null && $ctx->isDebug && $this->isRunningInPhar()) {
+            $listener->dispatch($intention = new ConsoleDetaching($ctx, $driver));
+
+            if ($intention->isCancelled) {
+                return null;
+            }
+
+            $driver->detach();
+
+            $listener->dispatch(new ConsoleDetached($ctx, $driver));
         }
 
         return null;
     }
 
-    private function createDriver(OperatingSystemExtensionInterface $operatingSystem): ?DetachConsoleDriverInterface
+    private function createDriver(OperatingSystemExtensionInterface $operatingSystem): ?ConsoleDriverInterface
     {
         if (!Runtime::isAvailable()) {
             return null;
         }
 
         if ($operatingSystem->family->is(Family::Windows)) {
-            return new WindowsDetachConsoleDriver();
+            return new WindowsConsoleDriver();
         }
 
         return null;

src/Api/Console/Driver/ConsoleDriverInterface.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\Console\Driver;
+
+interface ConsoleDriverInterface
+{
+    public function detach(): void;
+}

…etachConsole/Driver/Windows/Kernel32.php …/Api/Console/Driver/Windows/Kernel32.phpsrc/Api/DetachConsole/Driver/Windows/Kernel32.php renamed to src/Api/Console/Driver/Windows/Kernel32.php src/Api/DetachConsole/Driver/Windows/Kernel32.php renamed to src/Api/Console/Driver/Windows/Kernel32.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace Boson\Api\DetachConsole\Driver\Windows;
+namespace Boson\Api\Console\Driver\Windows;
 
 use FFI\Env\Runtime;
 
 /**
  * @mixin \FFI
  *
  * @internal this is an internal library class, please do not use it in your code
- * @psalm-internal Boson\Api\DetachConsole\Driver
+ * @psalm-internal Boson\Api\Console\Driver
  */
 final readonly class Kernel32
 {

…le/Driver/WindowsDetachConsoleDriver.php …/Console/Driver/WindowsConsoleDriver.phpsrc/Api/DetachConsole/Driver/WindowsDetachConsoleDriver.php renamed to src/Api/Console/Driver/WindowsConsoleDriver.php src/Api/DetachConsole/Driver/WindowsDetachConsoleDriver.php renamed to src/Api/Console/Driver/WindowsConsoleDriver.php

@@ -2,15 +2,17 @@
 
 declare(strict_types=1);
 
-namespace Boson\Api\DetachConsole\Driver;
+namespace Boson\Api\Console\Driver;
 
-use Boson\Api\DetachConsole\Driver\Windows\Kernel32;
+use Boson\Api\Console\Driver\Windows\Kernel32;
 
 /**
+ * @api
+ *
  * @internal this is an internal library class, please do not use it in your code
- * @psalm-internal Boson\Api\DetachConsole
+ * @psalm-internal Boson\Api\Console
  */
-final readonly class WindowsDetachConsoleDriver implements DetachConsoleDriverInterface
+final readonly class WindowsConsoleDriver implements ConsoleDriverInterface
 {
     public function __construct(
         private Kernel32 $kernel32 = new Kernel32(),

src/Api/Console/Event/ConsoleDetached.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\Console\Event;
+
+use Boson\Shared\Marker\AsApplicationEvent;
+
+#[AsApplicationEvent]
+final class ConsoleDetached extends ConsoleEvent {}