Rename "extension providers" to "extensions"

Author: SerafimArts

resources/.phpstorm.autocomplete.php

@@ -4,27 +4,26 @@
 
 namespace Boson {
 
-    use Boson\Api\CentralProcessor\CentralProcessorExtensionInterface;
-    use Boson\Api\Dialog\DialogExtensionInterface;
-    use Boson\Api\Alert\AlertExtensionInterface;
-    use Boson\Api\OperatingSystem\OperatingSystemExtensionInterface;
+    use Boson\Api\CentralProcessor\CentralProcessorInfoInterface;
+    use Boson\Api\Dialog\DialogApiInterface;
+    use Boson\Api\OperatingSystem\OperatingSystemInfoInterface;
 
     class Application
     {
         /**
          * Gets access to the Dialog API of the application.
          */
-        public readonly DialogExtensionInterface $dialog;
+        public readonly DialogApiInterface $dialog;
 
         /**
          * Gets access to the CPU Information API of the application.
          */
-        public readonly CentralProcessorExtensionInterface $cpu;
+        public readonly CentralProcessorInfoInterface $cpu;
 
         /**
          * Gets access to the OS Information API of the application.
          */
-        public readonly OperatingSystemExtensionInterface $os;
+        public readonly OperatingSystemInfoInterface $os;
     }
 
 }
@@ -40,12 +39,11 @@ class Window
 
 namespace Boson\WebView {
 
-    use Boson\WebView\Api\Bindings\BindingsExtensionInterface;
-    use Boson\WebView\Api\Data\DataExtensionInterface;
-    use Boson\WebView\Api\Schemes\SchemesExtensionInterface;
-    use Boson\WebView\Api\Scripts\ScriptsExtensionInterface;
-    use Boson\WebView\Api\Security\SecurityExtensionInterface;
-    use Boson\WebView\Api\WebComponents\WebComponentsExtensionInterface;
+    use Boson\WebView\Api\Bindings\BindingsApiInterface;
+    use Boson\WebView\Api\Data\DataRetrieverInterface;
+    use Boson\WebView\Api\Schemes\SchemesProviderInterface;
+    use Boson\WebView\Api\Scripts\ScriptsApiInterface;
+    use Boson\WebView\Api\Security\SecurityInfoInterface;
 
     class WebView
     {
@@ -55,33 +53,33 @@ class WebView
          * Provides the ability to register PHP functions
          * in the webview.
          */
-        public readonly BindingsExtensionInterface $bindings;
+        public readonly BindingsApiInterface $bindings;
 
         /**
          * Gets access to the Data API of the webview.
          *
          * Provides the ability to receive variant data from
          * the current document.
          */
-        public readonly DataExtensionInterface $data;
+        public readonly DataRetrieverInterface $data;
 
         /**
          * Gets access to the Schemes API of the webview.
          */
-        public readonly SchemesExtensionInterface $schemes;
+        public readonly SchemesProviderInterface $schemes;
 
         /**
          * Gets access to the Scripts API of the webview.
          *
          * Provides the ability to register a JavaScript code
          * in the webview.
          */
-        public readonly ScriptsExtensionInterface $scripts;
+        public readonly ScriptsApiInterface $scripts;
 
         /**
          * Gets access to the Security API of the webview.
          */
-        public readonly SecurityExtensionInterface $security;
+        public readonly SecurityInfoInterface $security;
 
     }
 

…Api/Autorun/AutorunExtensionProvider.php src/Api/Autorun/AutorunExtension.phpsrc/Api/Autorun/AutorunExtensionProvider.php renamed to src/Api/Autorun/AutorunExtension.php src/Api/Autorun/AutorunExtensionProvider.php renamed to src/Api/Autorun/AutorunExtension.php

@@ -11,12 +11,12 @@
 use Boson\Contracts\Id\IdentifiableInterface;
 use Boson\Dispatcher\EventListener;
 use Boson\Event\ApplicationStarted;
-use Boson\Extension\ExtensionProvider;
+use Boson\Extension\Extension;
 
 /**
- * @template-extends ExtensionProvider<Application>
+ * @template-extends Extension<Application>
  */
-final class AutorunExtensionProvider extends ExtensionProvider
+final class AutorunExtension extends Extension
 {
     /**
      * List of loaded applications that have never been launched

src/Api/CentralProcessor/CentralProcessorExtension.php

@@ -4,43 +4,21 @@
 
 namespace Boson\Api\CentralProcessor;
 
-use Boson\Api\ApplicationExtension;
-use Boson\Component\CpuInfo\ArchitectureInterface;
-use Boson\Component\CpuInfo\CentralProcessor;
+use Boson\Application;
 use Boson\Component\CpuInfo\CentralProcessorInterface;
+use Boson\Contracts\Id\IdentifiableInterface;
+use Boson\Dispatcher\EventListener;
+use Boson\Extension\Attribute\AvailableAs;
+use Boson\Extension\Extension;
 
 /**
- * @internal this is an internal library class, please do not use it in your code
- * @psalm-internal Boson\Api\CentralProcessor
+ * @template-extends Extension<Application>
  */
-final class CentralProcessorExtension extends ApplicationExtension implements
-    CentralProcessorExtensionInterface
+#[AvailableAs('cpu', CentralProcessorInfoInterface::class, CentralProcessorInterface::class)]
+final class CentralProcessorExtension extends Extension
 {
-    private CentralProcessorInterface $cpu {
-        get => $this->cpu ??= CentralProcessor::createFromGlobals();
-    }
-
-    public ArchitectureInterface $arch {
-        get => $this->cpu->arch;
-    }
-
-    public string $name {
-        get => $this->cpu->name;
-    }
-
-    public ?string $vendor {
-        get => $this->cpu->vendor;
-    }
-
-    public int $physicalCores {
-        get => $this->cpu->physicalCores;
-    }
-
-    public int $logicalCores {
-        get => $this->cpu->logicalCores;
-    }
-
-    public iterable $instructionSets {
-        get => $this->cpu->instructionSets;
+    public function load(IdentifiableInterface $ctx, EventListener $listener): CentralProcessorInfo
+    {
+        return new CentralProcessorInfo();
     }
 }

src/Api/CentralProcessor/CentralProcessorExtensionProvider.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\CentralProcessor;
+
+use Boson\Component\CpuInfo\ArchitectureInterface;
+use Boson\Component\CpuInfo\CentralProcessor;
+use Boson\Component\CpuInfo\CentralProcessorInterface;
+
+/**
+ * @internal this is an internal library class, please do not use it in your code
+ * @psalm-internal Boson\Api\CentralProcessor
+ */
+final class CentralProcessorInfo implements CentralProcessorInfoInterface
+{
+    private CentralProcessorInterface $cpu {
+        get => $this->cpu ??= CentralProcessor::createFromGlobals();
+    }
+
+    public ArchitectureInterface $arch {
+        get => $this->cpu->arch;
+    }
+
+    public string $name {
+        get => $this->cpu->name;
+    }
+
+    public ?string $vendor {
+        get => $this->cpu->vendor;
+    }
+
+    public int $physicalCores {
+        get => $this->cpu->physicalCores;
+    }
+
+    public int $logicalCores {
+        get => $this->cpu->logicalCores;
+    }
+
+    public iterable $instructionSets {
+        get => $this->cpu->instructionSets;
+    }
+}

src/Api/CentralProcessor/CentralProcessorInfo.php

@@ -9,5 +9,5 @@
 /**
  * Provides information about the main CPU.
  */
-interface CentralProcessorExtensionInterface extends
+interface CentralProcessorInfoInterface extends
     CentralProcessorInterface {}

…r/CentralProcessorExtensionInterface.php …cessor/CentralProcessorInfoInterface.phpsrc/Api/CentralProcessor/CentralProcessorExtensionInterface.php renamed to src/Api/CentralProcessor/CentralProcessorInfoInterface.php src/Api/CentralProcessor/CentralProcessorExtensionInterface.php renamed to src/Api/CentralProcessor/CentralProcessorInfoInterface.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace Boson\Api\Console\Driver;
+namespace Boson\Api\Console;
 
-interface ConsoleDriverInterface
+interface ConsoleApiInterface
 {
     public function detach(): void;
 }

…onsole/Driver/ConsoleDriverInterface.php src/Api/Console/ConsoleApiInterface.phpsrc/Api/Console/Driver/ConsoleDriverInterface.php renamed to src/Api/Console/ConsoleApiInterface.php src/Api/Console/Driver/ConsoleDriverInterface.php renamed to src/Api/Console/ConsoleApiInterface.php

@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\Console;
+
+use Boson\Api\Console\Driver\VoidConsole;
+use Boson\Api\Console\Driver\WindowsConsole;
+use Boson\Api\Console\Event\ConsoleDetached;
+use Boson\Api\Console\Event\ConsoleDetaching;
+use Boson\Api\OperatingSystem\OperatingSystemExtension;
+use Boson\Api\OperatingSystem\OperatingSystemInfoInterface;
+use Boson\Application;
+use Boson\Component\OsInfo\Family;
+use Boson\Contracts\Id\IdentifiableInterface;
+use Boson\Dispatcher\EventListener;
+use Boson\Extension\Attribute\AvailableAs;
+use Boson\Extension\Attribute\DependsOn;
+use Boson\Extension\Extension;
+use FFI\Env\Runtime;
+
+/**
+ * @template-extends Extension<Application>
+ */
+#[AvailableAs('console', ConsoleApiInterface::class)]
+#[DependsOn(OperatingSystemExtension::class)]
+final class ConsoleExtension extends Extension
+{
+    public function load(IdentifiableInterface $ctx, EventListener $listener): ConsoleApiInterface
+    {
+        $console = $this->createDriver($ctx->get(OperatingSystemInfoInterface::class));
+
+        if ($this->shouldDetachConsole($ctx)) {
+            $listener->dispatch($intention = new ConsoleDetaching($ctx, $console));
+
+            if ($intention->isCancelled) {
+                return $console;
+            }
+
+            $console->detach();
+
+            $listener->dispatch(new ConsoleDetached($ctx, $console));
+        }
+
+        return $console;
+    }
+
+    private function shouldDetachConsole(Application $app): bool
+    {
+        return !$app->isDebug
+            && $this->isRunningInPhar();
+    }
+
+    private function createDriver(OperatingSystemInfoInterface $operatingSystem): ConsoleApiInterface
+    {
+        if (!Runtime::isAvailable()) {
+            return new VoidConsole();
+        }
+
+        if ($operatingSystem->family->is(Family::Windows)) {
+            return new WindowsConsole();
+        }
+
+        return new VoidConsole();
+    }
+
+    private function isRunningInPhar(): bool
+    {
+        return \class_exists(\Phar::class)
+            && \Phar::running() !== '';
+    }
+}