refactor(documentator)!: Instruction templates reorganization.

packages/documentator/UPGRADE.md

@@ -42,3 +42,5 @@ Please also see [changelog](https://github.com/LastDragon-ru/lara-asp/releases)
 * [ ] Use [`Illuminate\Support\Facades\Process`](https://laravel.com/docs/processes) instead of `LastDragon_ru\LaraASP\Documentator\Utils\Process`.
 
 * [ ] If you are extending built-in instructions, their classes were moved to `LastDragon_ru\LaraASP\Documentator\Preprocessor\Instructions\<name>\Instruction` namespace.
+
+* [ ] If you are extending built-in templates, they were renamed from `markdown.blade.php` to `default.blade.php`.

packages/documentator/src/Commands/Commands.php

@@ -86,7 +86,7 @@ static function () use (
                     // Render
                     $name    = Str::after((string) $command->getName(), "{$namespace}:");
                     $path    = Path::getPath($target, "{$name}.md");
-                    $content = $viewer->render('commands.markdown', [
+                    $content = $viewer->render('commands.default', [
                         'serializer' => $serializer,
                         'command'    => $command,
                     ]);

packages/documentator/src/Commands/Requirements.php

@@ -145,7 +145,7 @@ public function __invoke(PackageViewer $viewer, Git $git, Serializer $serializer
         $requirements = $this->getRequirements($packages, $metadata);
 
         // Render
-        $output = $viewer->render('requirements.markdown', [
+        $output = $viewer->render('requirements.default', [
             'packages'     => $packages,
             'requirements' => $requirements,
         ]);

packages/documentator/src/Preprocessor/Instructions/IncludeDocumentList/Instruction.php

@@ -122,7 +122,7 @@ public function process(string $path, string $target, Serializable $parameters):
         });
 
         // Render
-        $template = 'document-list.'.($parameters->template ?: 'markdown');
+        $template = "document-list.{$parameters->template}";
         $list     = $this->viewer->render($template, [
             'documents' => $documents,
         ]);

packages/documentator/src/Preprocessor/Instructions/IncludeDocumentList/Parameters.php

@@ -12,7 +12,7 @@ public function __construct(
          * @var array<array-key, string|int>|string|int|null
          */
         public readonly array|string|int|null $depth = 0,
-        public readonly ?string $template = null,
+        public readonly string $template = 'default',
     ) {
         // empty
     }

packages/documentator/src/Preprocessor/Instructions/IncludePackageList/Instruction.php

@@ -141,7 +141,7 @@ public function process(string $path, string $target, Serializable $parameters):
         });
 
         // Render
-        $template = 'package-list.'.($parameters->template ?: 'markdown');
+        $template = "package-list.{$parameters->template}";
         $list     = $this->viewer->render($template, [
             'packages' => $packages,
         ]);

packages/documentator/src/Preprocessor/Instructions/IncludePackageList/InstructionTest.php

@@ -21,7 +21,7 @@ final class InstructionTest extends TestCase {
     /**
      * @dataProvider dataProviderProcess
      */
-    public function testProcess(string $expected, ?string $template): void {
+    public function testProcess(string $expected, string $template): void {
         $path     = self::getTestData()->file('Document.md')->getPathname();
         $target   = basename(self::getTestData()->path('/packages'));
         $params   = new Parameters(template: $template);
@@ -97,9 +97,8 @@ public function testProcessNoTitle(): void {
      */
     public static function dataProviderProcess(): array {
         return [
-            'no template' => ['~markdown.md', null],
-            'markdown'    => ['~markdown.md', 'markdown'],
-            'upgrade'     => ['~upgrade.md', 'upgrade'],
+            'default' => ['~default.md', 'default'],
+            'upgrade' => ['~upgrade.md', 'upgrade'],
         ];
     }
     // </editor-fold>

packages/documentator/src/Preprocessor/Instructions/IncludePackageList/Parameters.php

@@ -6,7 +6,7 @@
 
 class Parameters implements Serializable {
     public function __construct(
-        public readonly ?string $template = null,
+        public readonly string $template = 'default',
     ) {
         // empty
     }