[SPEC-001] Alias PivotPHP\Core\Application (feat)

docs/technical/application.md

@@ -33,6 +33,10 @@ $app->get('/', function($req, $res) {
 $app->run();
 ```
 
+> **Compatibilidade**: `PivotPHP\Core\Application` também funciona como alias de
+> `PivotPHP\Core\Core\Application` (retrocompatibilidade). O FQCN canônico é
+> `PivotPHP\Core\Core\Application`.
+
 ### Configuração Avançada
 
 ```php

src/aliases.php

@@ -80,3 +80,12 @@ class_alias(
         'PivotPHP\Core\Routing\RouterInstance'
     );
 }
+
+// Application - backward-compatibility alias for the pre-2.x FQCN
+// PivotPHP\Core\Application (the canonical class lives in PivotPHP\Core\Core\Application).
+if (class_exists('PivotPHP\Core\Core\Application')) {
+    class_alias(
+        'PivotPHP\Core\Core\Application',
+        'PivotPHP\Core\Application'
+    );
+}

tests/Unit/AliasesTest.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PivotPHP\Core\Tests\Unit;
+
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Cobre os aliases de compatibilidade registrados em src/aliases.php.
+ */
+class AliasesTest extends TestCase
+{
+    public function testApplicationAliasResolvesToCanonicalClass(): void
+    {
+        $this->assertTrue(class_exists('PivotPHP\Core\Application'));
+
+        $reflection = new \ReflectionClass('PivotPHP\Core\Application');
+        $this->assertSame('PivotPHP\Core\Core\Application', $reflection->getName());
+    }
+}