Use direct API execution instead of facade calls

Author: SerafimArts

resources/stubs/saucer.stub.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Boson\Internal\Saucer;
+namespace Boson\Api;
 
 use FFI\CData;
 use FFI\CType;

src/Api/ApplicationExtension.php

@@ -5,15 +5,36 @@
 namespace Boson\Api;
 
 use Boson\Application;
+use Boson\Contracts\Id\IdentifiableInterface;
 use Boson\Dispatcher\EventListener;
+use Boson\Internal\StructPointerId;
+use FFI\CData;
 
 /**
- * @template-extends Extension<Application>
+ * @template TContext of IdentifiableInterface<StructPointerId> = Application
+ *
+ * @template-extends Extension<TContext>
  */
 abstract class ApplicationExtension extends Extension
 {
-    public function __construct(Application $context, EventListener $listener)
-    {
-        parent::__construct($context, $listener);
+    /**
+     * Gets reference to the context's ID
+     */
+    protected StructPointerId $id {
+        get => $this->app->id;
+    }
+
+    /**
+     * Gets reference to the context's pointer
+     */
+    protected CData $ptr {
+        get => $this->id->ptr;
+    }
+
+    public function __construct(
+        protected readonly Application $app,
+        EventListener $listener,
+    ) {
+        parent::__construct($listener);
     }
 }

src/Api/CentralProcessor/AdvancedCpuInfoProviderInterface.php

@@ -14,7 +14,7 @@
  * @internal this is an internal library class, please do not use it in your code
  * @psalm-internal Boson
  */
-final class ApplicationCentralProcessor extends ApplicationExtension implements
+final class CentralProcessorApi extends ApplicationExtension implements
     CentralProcessorApiInterface
 {
     private CentralProcessorInterface $cpu {

…rocessor/ApplicationCentralProcessor.php …CentralProcessor/CentralProcessorApi.phpsrc/Api/CentralProcessor/ApplicationCentralProcessor.php renamed to src/Api/CentralProcessor/CentralProcessorApi.php src/Api/CentralProcessor/ApplicationCentralProcessor.php renamed to src/Api/CentralProcessor/CentralProcessorApi.php

@@ -4,14 +4,10 @@
 
 namespace Boson\Api;
 
-use Boson\Api\CentralProcessor\AdvancedCpuInfoProviderInterface;
-use Boson\Api\CentralProcessor\GenericCpuInfoProviderInterface;
-use Boson\Api\CentralProcessor\VendorCpuInfoProviderInterface;
+use Boson\Component\CpuInfo\CentralProcessorInterface;
 
 /**
  * Provides information about the main CPU.
  */
 interface CentralProcessorApiInterface extends
-    GenericCpuInfoProviderInterface,
-    VendorCpuInfoProviderInterface,
-    AdvancedCpuInfoProviderInterface {}
+    CentralProcessorInterface {}

src/Api/CentralProcessor/GenericCpuInfoProviderInterface.php

@@ -6,16 +6,16 @@
 
 use Boson\Api\ApplicationExtension;
 use Boson\Api\DialogApiInterface;
+use Boson\Api\SaucerInterface;
 use Boson\Application;
 use Boson\Dispatcher\EventListener;
-use Boson\Internal\Saucer\SaucerInterface;
 use FFI\CData;
 
 /**
  * @internal this is an internal library class, please do not use it in your code
  * @psalm-internal Boson
  */
-final class ApplicationDialog extends ApplicationExtension implements DialogApiInterface
+final class DialogApi extends ApplicationExtension implements DialogApiInterface
 {
     protected CData $ptr {
         /** @phpstan-ignore-next-line : PHPStan does not support property inheritance */

src/Api/CentralProcessor/VendorCpuInfoProviderInterface.php

@@ -10,28 +10,14 @@
 use Boson\Dispatcher\EventListener;
 use Boson\Dispatcher\Intention;
 use Boson\Internal\StructPointerId;
-use FFI\CData;
 
 /**
- * @template T of IdentifiableInterface<StructPointerId>
+ * @template TContext of IdentifiableInterface<StructPointerId>
  */
 abstract class Extension
 {
-    protected StructPointerId $id {
-        /** @phpstan-ignore-next-line : Context is a "IdentifiableInterface<StructPointerId>" */
-        get => $this->context->id;
-    }
-
-    protected CData $ptr {
-        get => $this->id->ptr;
-    }
-
     public function __construct(
-        /**
-         * @var T
-         */
-        protected readonly IdentifiableInterface $context,
-        private readonly EventListener $listener,
+        protected readonly EventListener $listener,
     ) {}
 
     /**
@@ -48,7 +34,10 @@ protected function listen(string $event, callable $then): CancellableSubscriptio
     }
 
     /**
-     * @param Intention<T> $intention
+     * Dispatch intention instance and returns {@see false} in
+     * case of intention has been cancelled.
+     *
+     * @param Intention<TContext> $intention
      */
     protected function intent(object $intention): bool
     {
@@ -58,7 +47,9 @@ protected function intent(object $intention): bool
     }
 
     /**
-     * @param Event<T> $event
+     * Dispatch immutable event.
+     *
+     * @param Event<TContext> $event
      */
     protected function dispatch(object $event): void
     {

src/Api/CentralProcessorApiInterface.php

@@ -15,7 +15,7 @@
  * @internal this is an internal library class, please do not use it in your code
  * @psalm-internal Boson
  */
-final class ApplicationOperatingSystem extends ApplicationExtension implements
+final class OperatingSystemApi extends ApplicationExtension implements
     OperatingSystemApiInterface
 {
     private OperatingSystemInterface $os {