release: Autumn Evolution 🍂

This version is the deep refactoring of how the Application/Config and other global Laravel things are injected into classes (no implicit dependencies, see #151), how the package configs looks (no more untyped arrays, see #152), how the `Formatter` works internally (simplification and more extendabilities). And, probably the most interesting part, is improvements of the `Documentator` - the `Processor` is used for all tasks, the links will be correctly updated when one document is included into another; code links support, etc. Please follow [Upgrade Guide](https://github.com/LastDragon-ru/lara-asp/blob/main/UPGRADE.md) to migrate 🤗. You can ask a question and/or discuss in [release disscussion](#201).
LastDragon-ru · Nov 17, 2024 · af69ffa · af69ffa
1 parent bc41eeb
commit af69ffa
Show file tree

Hide file tree

Showing 41 changed files with 174 additions and 49 deletions.
diff --git a/metadata.json b/metadata.json
@@ -1,5 +1,5 @@
 {
-    "version": "6.4.0",
+    "version": "7.0.0",
     "require": [],
     "merge": null,
     "requirements": {
@@ -13,6 +13,16 @@
                 "^8.2"
             ]
         },
+        "7.0.0": {
+            "laravel/framework": [
+                "^11.0.0",
+                "^10.34.0"
+            ],
+            "php": [
+                "^8.3",
+                "^8.2"
+            ]
+        },
         "6.4.2": {
             "laravel/framework": [
                 "^11.0.0",

diff --git a/packages/core/metadata.json b/packages/core/metadata.json
@@ -1,5 +1,5 @@
 {
-    "version": "6.4.0",
+    "version": "7.0.0",
     "require": [],
     "merge": null,
     "requirements": {
@@ -13,6 +13,16 @@
                 "^8.2"
             ]
         },
+        "7.0.0": {
+            "laravel/framework": [
+                "^11.0.0",
+                "^10.34.0"
+            ],
+            "php": [
+                "^8.3",
+                "^8.2"
+            ]
+        },
         "6.4.2": {
             "laravel/framework": [
                 "^11.0.0",

diff --git a/packages/core/src/Application/Configuration/Configuration.php b/packages/core/src/Application/Configuration/Configuration.php
@@ -52,7 +52,7 @@ public function offsetUnset(mixed $offset): void {
     }
 
     /**
-     * @deprecated %{VERSION} Array-based config is deprecated. Please migrate to object-based config.
+     * @deprecated 7.0.0 Array-based config is deprecated. Please migrate to object-based config.
      *
      * @param array<array-key, mixed> $array
      */
@@ -68,7 +68,7 @@ public static function fromArray(array $array): static {
     }
 
     /**
-     * @deprecated %{VERSION}
+     * @deprecated 7.0.0
      */
     protected static function fromArrayGetPropertyName(int|string $property): string {
         if (!is_string($property)) {
@@ -89,7 +89,7 @@ protected static function fromArrayGetPropertyName(int|string $property): string
     }
 
     /**
-     * @deprecated %{VERSION}
+     * @deprecated 7.0.0
      */
     protected static function fromArrayGetPropertyValue(string $property, mixed $value): mixed {
         if (is_array($value) && (!array_is_list($value) || $value === [])) {

diff --git a/packages/core/src/Provider.php b/packages/core/src/Provider.php
@@ -3,7 +3,7 @@
 namespace LastDragon_ru\LaraASP\Core;
 
 /**
- * @deprecated %{VERSION} The {@see PackageProvider} should be used instead.
+ * @deprecated 7.0.0 The {@see PackageProvider} should be used instead.
  */
 class Provider extends PackageProvider {
     // empty

diff --git a/packages/core/src/Provider/WithConfig.php b/packages/core/src/Provider/WithConfig.php
@@ -22,12 +22,12 @@ trait WithConfig {
     use Helper;
 
     /**
-     * @deprecated %{VERSION} Please migrate to {@see self::registerConfig()} and object-based config.
+     * @deprecated 7.0.0 Please migrate to {@see self::registerConfig()} and object-based config.
      */
     protected function bootConfig(): void {
         trigger_deprecation(
             Package::Name,
-            '%{VERSION}',
+            '7.0.0',
             'Please migrate to `self::registerConfig()` and object-based config.',
         );
 
@@ -86,7 +86,7 @@ private function loadPackageConfig(string $resolver): void {
                 // todo(core): Remove somewhere in v9 or later.
                 trigger_deprecation(
                     Package::Name,
-                    '%{VERSION}',
+                    '7.0.0',
                     'Array-based config is deprecated. Please migrate to object-based config.',
                 );
 

diff --git a/packages/core/src/Utils/ConfigMerger.php b/packages/core/src/Utils/ConfigMerger.php
@@ -16,12 +16,12 @@
 
 // phpcs:disable PSR1.Files.SideEffects
 
-trigger_deprecation(Package::Name, '%{VERSION}', 'Please migrate to object-based config.');
+trigger_deprecation(Package::Name, '7.0.0', 'Please migrate to object-based config.');
 
 /**
  * The merger for array-based configs.
  *
- * @deprecated %{VERSION} Please migrate to object-based config.
+ * @deprecated 7.0.0 Please migrate to object-based config.
  */
 class ConfigMerger {
     /**

diff --git a/packages/core/src/Utils/ConfigMergerTest.php b/packages/core/src/Utils/ConfigMergerTest.php
@@ -11,7 +11,7 @@
 
 /**
  * @internal
- * @deprecated %{VERSION}
+ * @deprecated 7.0.0
  */
 #[CoversClass(ConfigMerger::class)]
 final class ConfigMergerTest extends TestCase {

diff --git a/packages/core/src/Utils/Path.php b/packages/core/src/Utils/Path.php
@@ -13,10 +13,10 @@
 
 // phpcs:disable PSR1.Files.SideEffects
 
-trigger_deprecation(Package::Name, '%{VERSION}', 'Please use `%s`/`%s` instead.', FilePath::class, DirectoryPath::class);
+trigger_deprecation(Package::Name, '7.0.0', 'Please use `%s`/`%s` instead.', FilePath::class, DirectoryPath::class);
 
 /**
- * @deprecated %{VERSION} Please use {@see FilePath}/{@see DirectoryPath} instead.
+ * @deprecated 7.0.0 Please use {@see FilePath}/{@see DirectoryPath} instead.
  */
 class Path {
     public static function getPath(string $root, string $path): string {

diff --git a/packages/core/src/Utils/PathTest.php b/packages/core/src/Utils/PathTest.php
@@ -11,7 +11,7 @@
 
 /**
  * @internal
- * @deprecated %{VERSION}
+ * @deprecated 7.0.0
  */
 #[CoversClass(Path::class)]
 final class PathTest extends TestCase {

diff --git a/packages/dev/metadata.json b/packages/dev/metadata.json
@@ -1,5 +1,5 @@
 {
-    "version": "6.4.0",
+    "version": "7.0.0",
     "require": {
         "php": "PHP",
         "phpstan/phpstan": "PHPStan"
@@ -15,6 +15,15 @@
                 "^1.10"
             ]
         },
+        "7.0.0": {
+            "php": [
+                "^8.3",
+                "^8.2"
+            ],
+            "phpstan/phpstan": [
+                "^1.10"
+            ]
+        },
         "6.4.2": {
             "php": [
                 "^8.3",

diff --git a/packages/dev/src/Provider.php b/packages/dev/src/Provider.php
@@ -3,7 +3,7 @@
 namespace LastDragon_ru\LaraASP\Dev;
 
 /**
- * @deprecated %{VERSION} The {@see PackageProvider} should be used instead.
+ * @deprecated 7.0.0 The {@see PackageProvider} should be used instead.
  */
 class Provider extends PackageProvider {
     // empty

diff --git a/packages/documentator/metadata.json b/packages/documentator/metadata.json
@@ -1,5 +1,5 @@
 {
-    "version": "6.4.0",
+    "version": "7.0.0",
     "require": [],
     "merge": null,
     "requirements": {
@@ -13,6 +13,16 @@
                 "^8.2"
             ]
         },
+        "7.0.0": {
+            "laravel/framework": [
+                "^11.0.0",
+                "^10.34.0"
+            ],
+            "php": [
+                "^8.3",
+                "^8.2"
+            ]
+        },
         "6.4.2": {
             "laravel/framework": [
                 "^11.0.0",

diff --git a/packages/documentator/src/Processor/Metadata/PhpDocBlock.php b/packages/documentator/src/Processor/Metadata/PhpDocBlock.php
@@ -20,10 +20,10 @@
 
 // phpcs:disable PSR1.Files.SideEffects
 
-trigger_deprecation(Package::Name, '%{VERSION}', 'Please use `%s` instead.', PhpClassComment::class);
+trigger_deprecation(Package::Name, '7.0.0', 'Please use `%s` instead.', PhpClassComment::class);
 
 /**
- * @deprecated %{VERSION} Please use {@see PhpClassComment} instead.
+ * @deprecated 7.0.0 Please use {@see PhpClassComment} instead.
  *
  * @implements Metadata<?Document>
  */

diff --git a/packages/documentator/src/Processor/Metadata/PhpDocBlockTest.php b/packages/documentator/src/Processor/Metadata/PhpDocBlockTest.php
@@ -10,7 +10,7 @@
 use PHPUnit\Framework\Attributes\CoversClass;
 
 /**
- * @deprecated %{VERSION}
+ * @deprecated 7.0.0
  * @internal
  */
 #[CoversClass(PhpDocBlock::class)]

diff --git a/packages/documentator/src/Provider.php b/packages/documentator/src/Provider.php
@@ -3,7 +3,7 @@
 namespace LastDragon_ru\LaraASP\Documentator;
 
 /**
- * @deprecated %{VERSION} The {@see PackageProvider} should be used instead.
+ * @deprecated 7.0.0 The {@see PackageProvider} should be used instead.
  */
 class Provider extends PackageProvider {
     // empty

diff --git a/packages/documentator/src/Utils/Markdown.php b/packages/documentator/src/Utils/Markdown.php
@@ -30,10 +30,10 @@
 
 // phpcs:disable PSR1.Files.SideEffects
 
-trigger_deprecation(Package::Name, '%{VERSION}', 'Please use %s/%s instead.', MarkdownDocument::class, Text::class);
+trigger_deprecation(Package::Name, '7.0.0', 'Please use %s/%s instead.', MarkdownDocument::class, Text::class);
 
 /**
- * @deprecated %{VERSION} Please use {@see MarkdownDocument}/{@see Text} instead.
+ * @deprecated 7.0.0 Please use {@see MarkdownDocument}/{@see Text} instead.
  */
 class Markdown {
     /**

diff --git a/packages/documentator/src/Utils/MarkdownTest.php b/packages/documentator/src/Utils/MarkdownTest.php
@@ -7,7 +7,7 @@
 
 /**
  * @internal
- * @deprecated %{VERSION}
+ * @deprecated 7.0.0
  */
 #[CoversClass(Markdown::class)]
 final class MarkdownTest extends TestCase {

diff --git a/packages/eloquent/metadata.json b/packages/eloquent/metadata.json
@@ -1,5 +1,5 @@
 {
-    "version": "6.4.0",
+    "version": "7.0.0",
     "require": [],
     "merge": null,
     "requirements": {
@@ -13,6 +13,16 @@
                 "^8.2"
             ]
         },
+        "7.0.0": {
+            "laravel/framework": [
+                "^11.0.0",
+                "^10.34.0"
+            ],
+            "php": [
+                "^8.3",
+                "^8.2"
+            ]
+        },
         "6.4.2": {
             "laravel/framework": [
                 "^11.0.0",

diff --git a/packages/eloquent/src/Provider.php b/packages/eloquent/src/Provider.php
@@ -3,7 +3,7 @@
 namespace LastDragon_ru\LaraASP\Eloquent;
 
 /**
- * @deprecated %{VERSION} The {@see PackageProvider} should be used instead.
+ * @deprecated 7.0.0 The {@see PackageProvider} should be used instead.
  */
 class Provider extends PackageProvider {
     // empty

diff --git a/packages/formatter/metadata.json b/packages/formatter/metadata.json
@@ -1,5 +1,5 @@
 {
-    "version": "6.4.0",
+    "version": "7.0.0",
     "require": [],
     "merge": null,
     "requirements": {
@@ -13,6 +13,16 @@
                 "^8.2"
             ]
         },
+        "7.0.0": {
+            "laravel/framework": [
+                "^11.0.0",
+                "^10.34.0"
+            ],
+            "php": [
+                "^8.3",
+                "^8.2"
+            ]
+        },
         "6.4.2": {
             "laravel/framework": [
                 "^11.0.0",

diff --git a/packages/formatter/src/Config/Config.php b/packages/formatter/src/Config/Config.php
@@ -160,7 +160,7 @@ public function __construct(
     }
 
     /**
-     * @deprecated %{VERSION} Array-based config is deprecated. Please migrate to object-based config.
+     * @deprecated 7.0.0 Array-based config is deprecated. Please migrate to object-based config.
      * @inheritDoc
      */
     #[Override]

diff --git a/packages/formatter/src/PackageProviderTest.php b/packages/formatter/src/PackageProviderTest.php
@@ -24,7 +24,7 @@ public function testConfig(): void {
     }
 
     /**
-     * @deprecated %{VERSION} Array-base config is deprecated.
+     * @deprecated 7.0.0 Array-base config is deprecated.
      */
     public function testLegacyConfig(): void {
         // Prepare

diff --git a/packages/formatter/src/Provider.php b/packages/formatter/src/Provider.php
@@ -3,7 +3,7 @@
 namespace LastDragon_ru\LaraASP\Formatter;
 
 /**
- * @deprecated %{VERSION} The {@see PackageProvider} should be used instead.
+ * @deprecated 7.0.0 The {@see PackageProvider} should be used instead.
  */
 class Provider extends PackageProvider {
     // empty

diff --git a/packages/graphql-printer/metadata.json b/packages/graphql-printer/metadata.json
@@ -1,5 +1,5 @@
 {
-    "version": "6.4.0",
+    "version": "7.0.0",
     "require": {
         "php": "PHP",
         "webonyx/graphql-php": "`webonyx/graphql-php`"
@@ -15,6 +15,15 @@
                 "^15.4.0"
             ]
         },
+        "7.0.0": {
+            "php": [
+                "^8.3",
+                "^8.2"
+            ],
+            "webonyx/graphql-php": [
+                "^15.4.0"
+            ]
+        },
         "6.4.2": {
             "php": [
                 "^8.3",

diff --git a/packages/graphql/metadata.json b/packages/graphql/metadata.json
@@ -1,5 +1,5 @@
 {
-    "version": "6.4.0",
+    "version": "7.0.0",
     "require": {
         "php": "PHP",
         "laravel/framework": "Laravel",
@@ -20,6 +20,19 @@
                 "^8.2"
             ]
         },
+        "7.0.0": {
+            "laravel/framework": [
+                "^11.0.0",
+                "^10.34.0"
+            ],
+            "nuwave/lighthouse": [
+                "^6.5.0"
+            ],
+            "php": [
+                "^8.3",
+                "^8.2"
+            ]
+        },
         "6.4.2": {
             "laravel/framework": [
                 "^11.0.0",