Add whoops error handler

Author: SerafimArts

composer.json

@@ -42,6 +42,7 @@
         }
     },
     "require-dev": {
+        "filp/whoops": "^2.18",
         "phpunit/phpunit": "^12.0"
     },
     "autoload-dev": {
@@ -64,6 +65,9 @@
             "*": "dist"
         }
     },
+    "suggest": {
+        "filp/whoops": "Required for friendly error pages in development (^2.18)"
+    },
     "minimum-stability": "dev",
     "prefer-stable": true
 }

resources/.phpstorm.deprecations.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\WebView\Api\Schemes\Event {
+
+    use Boson\Contracts\Http\RequestInterface;
+    use Boson\Contracts\Http\ResponseInterface;
+    use Boson\WebView\WebView;
+
+    /**
+     * @deprecated Please use {@see SchemeRequestReceive} intention instead
+     */
+    final class SchemeRequestReceived extends SchemesApiIntention
+    {
+        public function __construct(
+            WebView $subject,
+            public readonly RequestInterface $request,
+            public ?ResponseInterface $response = null,
+            ?int $time = null,
+        ) {
+            parent::__construct($subject, $time);
+        }
+    }
+
+}

src/Application.php

@@ -69,7 +69,7 @@ class Application implements
     public readonly ApplicationId $id;
 
     /**
-     * Gets windows list and methods for working with windows.
+     * Gets a windows list and methods for working with windows.
      *
      * @api
      */
@@ -138,7 +138,7 @@ class Application implements
     public readonly bool $isDebug;
 
     /**
-     * Gets running state of an application.
+     * Gets the running state of an application.
      *
      * Contains {@see true} in case of application is running
      * or {@see false} instead.
@@ -182,7 +182,7 @@ class Application implements
      */
     public function __construct(
         /**
-         * Gets an information DTO about the application
+         * Gets information DTO about the application
          * with which it was created.
          */
         public readonly ApplicationCreateInfo $info = new ApplicationCreateInfo(),
@@ -202,7 +202,7 @@ public function __construct(
         $this->extensions = new Registry($this->listener, $info->extensions);
         foreach ($this->extensions->boot($this) as $property => $extension) {
             // Direct access to dynamic property is 5+ times
-            // faster than magic `__get` call.
+            // faster than the magic `__get` call.
             $this->__set($property, $extension);
         }
 
@@ -311,7 +311,7 @@ protected function createWindowManager(
     }
 
     /**
-     * Register list of protocol names that will be
+     * Register a list of protocol names that will be
      * intercepted by the application.
      */
     private function registerSchemes(): void
@@ -348,15 +348,15 @@ private function onWindowClose(): void
     /**
      * Handles an application started event.
      *
-     * Resolve main window lazy proxy (facade).
+     * Resolve the main window lazy proxy (facade).
      */
     private function onApplicationStarted(): void
     {
         $this->windows->boot();
     }
 
     /**
-     * Creates local (application-aware) event listener
+     * Creates a local (application-aware) event listener
      * based on the provided dispatcher.
      */
     protected function createEventListener(?EventDispatcherInterface $dispatcher): EventListener
@@ -439,7 +439,7 @@ private function shouldNotStart(): bool
     /**
      * Runs the application, starting the main event loop.
      *
-     * This method blocks main thread until the
+     * This method blocks the main thread until the
      * application is quit.
      *
      * @api

src/ApplicationCreateInfo.php

@@ -17,7 +17,7 @@
 //
 // Note:
 // 1) This "$_" assign hack removes these constants from IDE autocomplete.
-// 2) Only define-like constants allows object instances.
+// 2) Only define-like constants allow object instances.
 //
 \define($_ = 'Boson\DEFAULT_APPLICATION_EXTENSIONS', [
     new CentralProcessorExtension(),

src/WebView/Api/LifecycleEvents/LifecycleEventsListener.php

@@ -181,16 +181,17 @@ private function onSafeNavigated(CData $_, CData $url): void
 
     private function urlToString(CData $url): string
     {
-        $value = $this->app->saucer->new('char');
-        $size = $this->app->saucer->new('size_t');
+        $length = $this->app->saucer->new('size_t');
+        $this->app->saucer->saucer_url_string($url, null, \FFI::addr($length));
 
-        $this->app->saucer->saucer_url_string($url, \FFI::addr($value), \FFI::addr($size));
-
-        if ($size->cdata === 0) {
+        if ($length->cdata === 0) {
             return '';
         }
 
-        return \FFI::string($value, $size->cdata);
+        $value = $this->app->saucer->new("char[{$length->cdata}]");
+        $this->app->saucer->saucer_url_string($url, \FFI::addr($value[0]), \FFI::addr($length));
+
+        return \FFI::string(\FFI::addr($value[0]), $length->cdata);
     }
 
     private function onNavigating(CData $_, CData $navigation): int

src/WebView/Api/Schemes/Event/SchemeRequestFail.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\WebView\Api\Schemes\Event;
+
+use Boson\Contracts\Http\RequestInterface;
+use Boson\Contracts\Http\ResponseInterface;
+use Boson\Shared\Marker\AsWebViewIntention;
+use Boson\WebView\WebView;
+
+#[AsWebViewIntention]
+final class SchemeRequestFail extends SchemesApiIntention
+{
+    public function __construct(
+        WebView $subject,
+        public readonly RequestInterface $request,
+        public readonly \Throwable $exception,
+        public ?ResponseInterface $response = null,
+        ?int $time = null,
+    ) {
+        parent::__construct($subject, $time);
+    }
+}

src/WebView/Api/Schemes/Event/SchemeRequestReceive.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\WebView\Api\Schemes\Event;
+
+use Boson\Contracts\Http\RequestInterface;
+use Boson\Contracts\Http\ResponseInterface;
+use Boson\Shared\Marker\AsWebViewIntention;
+use Boson\WebView\WebView;
+
+#[AsWebViewIntention]
+final class SchemeRequestReceive extends SchemesApiIntention
+{
+    public function __construct(
+        WebView $subject,
+        public readonly RequestInterface $request,
+        public ?ResponseInterface $response = null,
+        ?int $time = null,
+    ) {
+        parent::__construct($subject, $time);
+    }
+}

src/WebView/Api/Schemes/Event/SchemeRequestReceived.php

@@ -4,20 +4,6 @@
 
 namespace Boson\WebView\Api\Schemes\Event;
 
-use Boson\Contracts\Http\RequestInterface;
-use Boson\Contracts\Http\ResponseInterface;
-use Boson\Shared\Marker\AsWebViewIntention;
-use Boson\WebView\WebView;
-
-#[AsWebViewIntention]
-final class SchemeRequestReceived extends SchemesApiIntention
-{
-    public function __construct(
-        WebView $subject,
-        public readonly RequestInterface $request,
-        public ?ResponseInterface $response = null,
-        ?int $time = null,
-    ) {
-        parent::__construct($subject, $time);
-    }
+if (!\class_exists(SchemeRequestReceived::class)) {
+    \class_alias(SchemeRequestReceive::class, SchemeRequestReceived::class);
 }

src/WebView/Api/Schemes/Event/SchemeRequestReject.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\WebView\Api\Schemes\Event;
+
+use Boson\Contracts\Http\Component\StatusCodeInterface;
+use Boson\Contracts\Http\RequestInterface;
+use Boson\Shared\Marker\AsWebViewIntention;
+use Boson\WebView\WebView;
+
+#[AsWebViewIntention]
+final class SchemeRequestReject extends SchemesApiIntention
+{
+    public function __construct(
+        WebView $subject,
+        public readonly RequestInterface $request,
+        public StatusCodeInterface $status,
+        ?int $time = null,
+    ) {
+        parent::__construct($subject, $time);
+    }
+}

src/WebView/Api/Schemes/Event/SchemeResponseProceed.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\WebView\Api\Schemes\Event;
+
+use Boson\Contracts\Http\RequestInterface;
+use Boson\Contracts\Http\ResponseInterface;
+use Boson\Shared\Marker\AsWebViewEvent;
+use Boson\WebView\WebView;
+
+#[AsWebViewEvent]
+final class SchemeResponseProceed extends SchemesApiEvent
+{
+    public function __construct(
+        WebView $subject,
+        public readonly RequestInterface $request,
+        public readonly ResponseInterface $response,
+        ?int $time = null,
+    ) {
+        parent::__construct($subject, $time);
+    }
+}