Actualize Saucer v8 API

Author: SerafimArts

resources/stubs/saucer.stub.php

@@ -2,7 +2,9 @@
 
 namespace Boson\Internal\WebView {
 
+    use Boson\Component\Saucer\Policy;
     use Boson\Component\Saucer\State;
+    use Boson\Component\Saucer\Status;
     use FFI\CData;
 
     /**
@@ -14,18 +16,28 @@
      */
     final class CSaucerWebViewEventsStruct extends CData
     {
+        /**
+         * @var null|\Closure(CData, CData, CData):(Status::SAUCER_STATE_*)
+         */
+        public null|\Closure $onPermissionRequested;
+
+        /**
+         * @var null|\Closure(CData, bool, CData):(Policy::SAUCER_POLICY_*)
+         */
+        public null|\Closure $onFullscreen;
+
         /**
          * @var null|\Closure(CData, CData):void
          */
         public null|\Closure $onDomReady;
 
         /**
-         * @var null|\Closure(CData, string, CData):void
+         * @var null|\Closure(CData, CData, CData):void
          */
         public null|\Closure $onNavigated;
 
         /**
-         * @var null|\Closure(CData, CData, CData):void
+         * @var null|\Closure(CData, CData, CData):(Policy::SAUCER_POLICY_*)
          */
         public null|\Closure $onNavigating;
 
@@ -35,7 +47,7 @@ final class CSaucerWebViewEventsStruct extends CData
         public null|\Closure $onFaviconChanged;
 
         /**
-         * @var null|\Closure(CData, string, CData):void
+         * @var null|\Closure(CData, string, int<0, max>, CData):void
          */
         public null|\Closure $onTitleChanged;
 
@@ -45,7 +57,7 @@ final class CSaucerWebViewEventsStruct extends CData
         public null|\Closure $onLoad;
 
         /**
-         * @var null|\Closure(CData, string, int<0, max>, CData):void
+         * @var null|\Closure(CData, string, int<0, max>, CData):(Status::SAUCER_STATE_*)
          */
         public null|\Closure $onMessage;
     }

src/Api/Dialog/Exception/DialogException.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\Dialog\Exception;
+
+use Boson\Exception\ApplicationApiException;
+
+class DialogException extends ApplicationApiException {}

src/Api/Dialog/Exception/InternalErrorDialogException.php

@@ -0,0 +1,7 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\Dialog\Exception;
+
+class InternalErrorDialogException extends DialogException {}

src/Api/Dialog/SaucerDialogApi.php

@@ -11,7 +11,10 @@
 use Boson\Api\Dialog\Event\FilesSelecting;
 use Boson\Api\Dialog\Event\UriOpened;
 use Boson\Api\Dialog\Event\UriOpening;
+use Boson\Api\Dialog\Exception\InternalErrorDialogException;
 use Boson\Api\LoadedApplicationExtension;
+use Boson\Application;
+use Boson\Dispatcher\EventListener;
 use Boson\Shared\Marker\RequiresDealloc;
 use FFI\CData;
 
@@ -27,6 +30,15 @@ final class SaucerDialogApi extends LoadedApplicationExtension implements
         get => $this->app->saucer->saucer_desktop_new(parent::$ptr::get());
     }
 
+    private readonly int $isCanceledCode;
+
+    public function __construct(Application $app, EventListener $listener)
+    {
+        parent::__construct($app, $listener);
+
+        $this->isCanceledCode = $this->app->saucer->boson_error_code_canceled();
+    }
+
     private function applyDirectory(CData $options, ?string $directory): void
     {
         $directory ??= \getcwd();
@@ -79,8 +91,14 @@ private function selectOne(?string $directory, array $filter, \Closure $selector
         $options = $this->createOptions($directory, $filter);
 
         try {
+            $error = $this->saucer->new('int');
+
             $length = $this->saucer->new('size_t');
-            $selector($this->ptr, $options, null, \FFI::addr($length), null);
+            $selector($this->ptr, $options, null, \FFI::addr($length), \FFI::addr($error));
+
+            if ($error->cdata !== 0 && $error->cdata !== $this->isCanceledCode) {
+                throw new InternalErrorDialogException('An error occurred while selecting a file/directory', $error->cdata);
+            }
 
             if ($length->cdata === 0) {
                 return null;
@@ -106,8 +124,14 @@ private function selectMany(?string $directory, array $filter, \Closure $selecto
         $options = $this->createOptions($directory, $filter);
 
         try {
+            $error = $this->saucer->new('int');
+
             $length = $this->saucer->new('size_t');
-            $selector($this->ptr, $options, null, \FFI::addr($length), null);
+            $selector($this->ptr, $options, null, \FFI::addr($length), \FFI::addr($error));
+
+            if ($error->cdata !== 0 && $error->cdata !== $this->isCanceledCode) {
+                throw new InternalErrorDialogException('An error occurred while selecting a files/directories', $error->cdata);
+            }
 
             if ($length->cdata === 0) {
                 return [];