refactor: improve container initialization check and enhance DevToolsServiceProvider documentation

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

Author: coisa

src/Console/DevTools.php

@@ -58,7 +58,7 @@ public function __construct(CommandLoaderInterface $commandLoader)
      */
     public static function create(): self
     {
-        if (self::$container === null) {
+        if (! self::$container instanceof ContainerInterface) {
             $serviceProvider = new DevToolsServiceProvider();
             self::$container = new Container($serviceProvider->getFactories());
         }

src/ServiceProvider/DevToolsServiceProvider.php

@@ -1,5 +1,21 @@
 <?php
 
+declare(strict_types=1);
+
+/**
+ * This file is part of fast-forward/dev-tools.
+ *
+ * This source file is subject to the license bundled
+ * with this source code in the file LICENSE.
+ *
+ * @copyright Copyright (c) 2026 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license   https://opensource.org/licenses/MIT MIT License
+ *
+ * @see       https://github.com/php-fast-forward/dev-tools
+ * @see       https://github.com/php-fast-forward
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
+ */
+
 namespace FastForward\DevTools\ServiceProvider;
 
 use Interop\Container\ServiceProviderInterface;
@@ -48,6 +64,9 @@
 
 final class DevToolsServiceProvider implements ServiceProviderInterface
 {
+    /**
+     * @return array
+     */
     public function getFactories(): array
     {
         return [
@@ -87,6 +106,9 @@ public function getFactories(): array
         ];
     }
 
+    /**
+     * @return array
+     */
     public function getExtensions(): array
     {
         return [];

tests/Composer/Capability/DevToolsCommandProviderTest.php

@@ -20,7 +20,6 @@
 
 use Composer\Command\BaseCommand;
 use FastForward\DevTools\Composer\Capability\DevToolsCommandProvider;
-use FastForward\DevTools\Console\Command\CodeStyleCommand;
 use FastForward\DevTools\Console\DevTools;
 use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
@@ -31,8 +30,6 @@
 use Psr\Container\ContainerInterface;
 use ReflectionProperty;
 use Symfony\Component\Console\Command\Command;
-use Symfony\Component\Console\CommandLoader\CommandLoaderInterface;
-use Symfony\Component\Filesystem\Filesystem;
 
 #[CoversClass(DevToolsCommandProvider::class)]
 #[UsesClass(DevTools::class)]
@@ -41,6 +38,7 @@ final class DevToolsCommandProviderTest extends TestCase
     use ProphecyTrait;
 
     private ObjectProphecy $container;
+
     private ObjectProphecy $devTools;
 
     private DevToolsCommandProvider $commandProvider;
@@ -57,14 +55,18 @@ protected function setUp(): void
             ->willReturn($this->devTools->reveal())
             ->shouldBeCalledOnce();
 
-        $this->devTools->all()->willReturn([])->shouldBeCalledOnce();
+        $this->devTools->all()
+            ->willReturn([])->shouldBeCalledOnce();
 
         $this->commandProvider = new DevToolsCommandProvider();
 
         $property = new ReflectionProperty(DevTools::class, 'container');
         $property->setValue(null, $this->container->reveal());
     }
 
+    /**
+     * @return void
+     */
     #[Test]
     public function getCommandsWillReturnEmptyArrayWhenNoCommandsAreRegistered(): void
     {
@@ -74,16 +76,17 @@ public function getCommandsWillReturnEmptyArrayWhenNoCommandsAreRegistered(): vo
         self::assertEmpty($commands);
     }
 
+    /**
+     * @return void
+     */
     #[Test]
     public function getCommandsWillReturnRegisteredBaseCommands(): void
     {
         $composerCommand = $this->prophesize(BaseCommand::class)->reveal();
         $symfonyCommand = $this->prophesize(Command::class)->reveal();
 
-        $this->devTools->all()->willReturn([
-            $composerCommand,
-            $symfonyCommand,
-        ])->shouldBeCalledOnce();
+        $this->devTools->all()
+            ->willReturn([$composerCommand, $symfonyCommand])->shouldBeCalledOnce();
 
         $commands = $this->commandProvider->getCommands();
 

tests/ServiceProvider/DevToolsServiceProviderTest.php

@@ -3,8 +3,17 @@
 declare(strict_types=1);
 
 /**
+ * This file is part of fast-forward/dev-tools.
+ *
+ * This source file is subject to the license bundled
+ * with this source code in the file LICENSE.
+ *
  * @copyright Copyright (c) 2026 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
  * @license   https://opensource.org/licenses/MIT MIT License
+ *
+ * @see       https://github.com/php-fast-forward/dev-tools
+ * @see       https://github.com/php-fast-forward
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
  */
 
 namespace FastForward\DevTools\Tests\ServiceProvider;
@@ -20,23 +29,35 @@ final class DevToolsServiceProviderTest extends TestCase
 {
     private DevToolsServiceProvider $provider;
 
+    /**
+     * @return void
+     */
     protected function setUp(): void
     {
         $this->provider = new DevToolsServiceProvider();
     }
 
+    /**
+     * @return void
+     */
     #[Test]
     public function implementsServiceProviderInterface(): void
     {
         self::assertInstanceOf(ServiceProviderInterface::class, $this->provider);
     }
 
+    /**
+     * @return void
+     */
     #[Test]
     public function getExtensionsReturnEmptyArray(): void
     {
         self::assertEmpty($this->provider->getExtensions());
     }
 
+    /**
+     * @return void
+     */
     #[Test]
     public function getFactoriesReturnFactories(): void
     {