CONV-055: Add recommended target metadata

app/Support/Converters/Contracts/Converter.php

@@ -17,4 +17,6 @@ public function description(): string;
     public function optionsSchema(): array;
 
     public function validateOptions(array $options): array;
+
+    public function isRecommended(): bool;
 }

app/Support/Converters/ConverterRegistry.php

@@ -53,7 +53,7 @@ public function targetsFor(string $source): array
                 label: $converter->label(),
                 description: $converter->description(),
                 converterKey: $converter->key(),
-                recommended: false,
+                recommended: $converter->isRecommended(),
             ),
             $this->forSource($source),
         );

app/Support/Converters/Image/JpgToPdfConverter.php

@@ -101,4 +101,9 @@ public function validateOptions(array $options): array
     {
         return $this->optionsValidator->validate($this->optionsSchema(), $options);
     }
+
+    public function isRecommended(): bool
+    {
+        return false;
+    }
 }

app/Support/Converters/Image/JpgToPngConverter.php

@@ -64,4 +64,9 @@ public function validateOptions(array $options): array
     {
         return $this->optionsValidator->validate($this->optionsSchema(), $options);
     }
+
+    public function isRecommended(): bool
+    {
+        return false;
+    }
 }

app/Support/Converters/Image/JpgToWebpConverter.php

@@ -75,4 +75,9 @@ public function validateOptions(array $options): array
     {
         return $this->optionsValidator->validate($this->optionsSchema(), $options);
     }
+
+    public function isRecommended(): bool
+    {
+        return true;
+    }
 }

app/Support/Converters/Image/PngToJpgConverter.php

@@ -81,4 +81,9 @@ public function validateOptions(array $options): array
     {
         return $this->optionsValidator->validate($this->optionsSchema(), $options);
     }
+
+    public function isRecommended(): bool
+    {
+        return true;
+    }
 }

app/Support/Converters/Image/PngToPdfConverter.php

@@ -101,4 +101,9 @@ public function validateOptions(array $options): array
     {
         return $this->optionsValidator->validate($this->optionsSchema(), $options);
     }
+
+    public function isRecommended(): bool
+    {
+        return false;
+    }
 }

app/Support/Converters/Image/PngToWebpConverter.php

@@ -81,4 +81,9 @@ public function validateOptions(array $options): array
     {
         return $this->optionsValidator->validate($this->optionsSchema(), $options);
     }
+
+    public function isRecommended(): bool
+    {
+        return false;
+    }
 }

tests/Fakes/Converters/FakeJpgToWebpConverter.php

@@ -40,4 +40,9 @@ public function validateOptions(array $options): array
     {
         return $options;
     }
+
+    public function isRecommended(): bool
+    {
+        return false;
+    }
 }

tests/Fakes/Converters/FakePngToJpgConverter.php

@@ -40,4 +40,9 @@ public function validateOptions(array $options): array
     {
         return $options;
     }
+
+    public function isRecommended(): bool
+    {
+        return false;
+    }
 }

tests/Fakes/Converters/FakePngToPdfConverter.php

@@ -40,4 +40,9 @@ public function validateOptions(array $options): array
     {
         return $options;
     }
+
+    public function isRecommended(): bool
+    {
+        return false;
+    }
 }

tests/Unit/Converters/RecommendedTargetMetadataTest.php

@@ -0,0 +1,37 @@
+<?php
+
+use App\Support\Converters\ConverterRegistry;
+use App\Support\Converters\Image\JpgToPdfConverter;
+use App\Support\Converters\Image\JpgToPngConverter;
+use App\Support\Converters\Image\JpgToWebpConverter;
+use App\Support\Converters\Image\PngToJpgConverter;
+use App\Support\Converters\Image\PngToPdfConverter;
+use App\Support\Converters\Image\PngToWebpConverter;
+
+function mvpRegistry(): ConverterRegistry
+{
+    return new ConverterRegistry([
+        app(PngToJpgConverter::class),
+        app(PngToWebpConverter::class),
+        app(PngToPdfConverter::class),
+        app(JpgToPngConverter::class),
+        app(JpgToWebpConverter::class),
+        app(JpgToPdfConverter::class),
+    ]);
+}
+
+it('marks one png target as recommended', function () {
+    $recommended = collect(mvpRegistry()->targetsFor('png'))
+        ->filter(fn ($target) => $target->recommended === true);
+
+    expect($recommended)->toHaveCount(1);
+    expect($recommended->first()->format)->toBe('jpg');
+});
+
+it('marks one jpg target as recommended', function () {
+    $recommended = collect(mvpRegistry()->targetsFor('jpg'))
+        ->filter(fn ($target) => $target->recommended === true);
+
+    expect($recommended)->toHaveCount(1);
+    expect($recommended->first()->format)->toBe('webp');
+});