From 3a063e45b85cde9c363b386a28b4df3243c5a76a Mon Sep 17 00:00:00 2001
From: Caio Fernandes <caio.alberto.fernandes@hotmail.com>
Date: Thu, 8 Oct 2026 23:18:23 -0300
Subject: [PATCH] feat(core): add PivotPHP\Core\Application backward-compat
 alias

- class_alias to PivotPHP\Core\Core\Application in src/aliases.php.
- Document the alias in docs/technical/application.md.

Refs: SPEC-001 (PivotPHP/pivotphp-skeleton#1)
---
 docs/technical/application.md |  4 ++++
 src/aliases.php               |  9 +++++++++
 tests/Unit/AliasesTest.php    | 21 +++++++++++++++++++++
 3 files changed, 34 insertions(+)
 create mode 100644 tests/Unit/AliasesTest.php

diff --git a/docs/technical/application.md b/docs/technical/application.md
index 7b6c108..a4d6c3a 100644
--- a/docs/technical/application.md
+++ b/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
diff --git a/src/aliases.php b/src/aliases.php
index e29b71b..8ea168c 100644
--- a/src/aliases.php
+++ b/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'
+    );
+}
diff --git a/tests/Unit/AliasesTest.php b/tests/Unit/AliasesTest.php
new file mode 100644
index 0000000..bfa4367
--- /dev/null
+++ b/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());
+    }
+}