Release v0.1.4 — Phase 04 MVP Converter Capabilities

.coderabbit.yaml

@@ -11,6 +11,8 @@ reviews:
     enabled: true
     labels:
       - "release"
+    base_branches:
+      - "main"
     drafts: false
   request_changes_workflow: false
   high_level_summary: true

app/Providers/ConverterServiceProvider.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Providers;
+
+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;
+use Illuminate\Support\ServiceProvider;
+
+class ConverterServiceProvider extends ServiceProvider
+{
+    public function register(): void
+    {
+        $this->app->singleton(ConverterRegistry::class, function ($app) {
+            return new ConverterRegistry([
+                $app->make(PngToJpgConverter::class),
+                $app->make(PngToWebpConverter::class),
+                $app->make(PngToPdfConverter::class),
+                $app->make(JpgToPngConverter::class),
+                $app->make(JpgToWebpConverter::class),
+                $app->make(JpgToPdfConverter::class),
+            ]);
+        });
+    }
+}

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

@@ -5,6 +5,7 @@
 use App\Enums\FileFormat;
 use App\Support\Converters\Contracts\Converter;
 use App\Support\Converters\DTO\ConverterTarget;
+use App\Support\Converters\Exceptions\UnsupportedFormatException;
 
 final class ConverterRegistry
 {
@@ -22,7 +23,11 @@ public function all(): array
     /** @return list<Converter> */
     public function forSource(string $source): array
     {
-        $source = FileFormat::normalize($source);
+        try {
+            $source = FileFormat::normalize($source);
+        } catch (UnsupportedFormatException) {
+            return [];
+        }
 
         return array_values(array_filter(
             $this->converters,
@@ -32,8 +37,12 @@ public function forSource(string $source): array
 
     public function find(string $source, string $target): ?Converter
     {
-        $source = FileFormat::normalize($source);
-        $target = FileFormat::normalize($target);
+        try {
+            $source = FileFormat::normalize($source);
+            $target = FileFormat::normalize($target);
+        } catch (UnsupportedFormatException) {
+            return null;
+        }
 
         foreach ($this->converters as $converter) {
             if ($converter->sourceFormat() === $source && $converter->targetFormat() === $target) {
@@ -53,7 +62,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

@@ -0,0 +1,109 @@
+<?php
+
+namespace App\Support\Converters\Image;
+
+use App\Support\Converters\Contracts\Converter;
+use App\Support\Converters\OptionsValidator;
+
+final class JpgToPdfConverter implements Converter
+{
+    public function __construct(
+        private readonly OptionsValidator $optionsValidator,
+    ) {}
+
+    public function key(): string
+    {
+        return 'jpg:pdf';
+    }
+
+    public function sourceFormat(): string
+    {
+        return 'jpg';
+    }
+
+    public function targetFormat(): string
+    {
+        return 'pdf';
+    }
+
+    public function label(): string
+    {
+        return 'PDF';
+    }
+
+    public function description(): string
+    {
+        return 'Create a PDF document from image';
+    }
+
+    public function optionsSchema(): array
+    {
+        return [
+            [
+                'key' => 'page_size',
+                'type' => 'segmented',
+                'label' => 'Page size',
+                'default' => 'auto',
+                'options' => [
+                    ['value' => 'auto', 'label' => 'Auto'],
+                    ['value' => 'a4', 'label' => 'A4'],
+                    ['value' => 'letter', 'label' => 'Letter'],
+                ],
+            ],
+            [
+                'key' => 'orientation',
+                'type' => 'segmented',
+                'label' => 'Orientation',
+                'default' => 'auto',
+                'options' => [
+                    ['value' => 'auto', 'label' => 'Auto'],
+                    ['value' => 'portrait', 'label' => 'Portrait'],
+                    ['value' => 'landscape', 'label' => 'Landscape'],
+                ],
+            ],
+            [
+                'key' => 'margin',
+                'type' => 'segmented',
+                'label' => 'Margin',
+                'default' => 'small',
+                'options' => [
+                    ['value' => 'none', 'label' => 'None'],
+                    ['value' => 'small', 'label' => 'Small'],
+                    ['value' => 'medium', 'label' => 'Medium'],
+                ],
+            ],
+            [
+                'key' => 'fit_mode',
+                'type' => 'segmented',
+                'label' => 'Fit mode',
+                'default' => 'contain',
+                'options' => [
+                    ['value' => 'contain', 'label' => 'Contain'],
+                    ['value' => 'cover', 'label' => 'Cover'],
+                    ['value' => 'original', 'label' => 'Original'],
+                ],
+            ],
+            [
+                'key' => 'compression',
+                'type' => 'segmented',
+                'label' => 'Compression',
+                'default' => 'balanced',
+                'options' => [
+                    ['value' => 'none', 'label' => 'None'],
+                    ['value' => 'balanced', 'label' => 'Balanced'],
+                    ['value' => 'small', 'label' => 'Small'],
+                ],
+            ],
+        ];
+    }
+
+    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

@@ -0,0 +1,72 @@
+<?php
+
+namespace App\Support\Converters\Image;
+
+use App\Support\Converters\Contracts\Converter;
+use App\Support\Converters\OptionsValidator;
+
+final class JpgToPngConverter implements Converter
+{
+    public function __construct(
+        private readonly OptionsValidator $optionsValidator,
+    ) {}
+
+    public function key(): string
+    {
+        return 'jpg:png';
+    }
+
+    public function sourceFormat(): string
+    {
+        return 'jpg';
+    }
+
+    public function targetFormat(): string
+    {
+        return 'png';
+    }
+
+    public function label(): string
+    {
+        return 'PNG';
+    }
+
+    public function description(): string
+    {
+        return 'Convert photo to lossless PNG image';
+    }
+
+    public function optionsSchema(): array
+    {
+        return [
+            [
+                'key' => 'resize',
+                'type' => 'select',
+                'label' => 'Resize',
+                'default' => 'original',
+                'options' => [
+                    ['value' => 'original', 'label' => 'Original'],
+                    ['value' => '1920', 'label' => '1920 px'],
+                    ['value' => '1280', 'label' => '1280 px'],
+                    ['value' => 'custom', 'label' => 'Custom'],
+                ],
+            ],
+            [
+                'key' => 'remove_metadata',
+                'type' => 'toggle',
+                'label' => 'Remove metadata',
+                'default' => true,
+            ],
+        ];
+    }
+
+    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

@@ -0,0 +1,83 @@
+<?php
+
+namespace App\Support\Converters\Image;
+
+use App\Support\Converters\Contracts\Converter;
+use App\Support\Converters\OptionsValidator;
+
+final class JpgToWebpConverter implements Converter
+{
+    public function __construct(
+        private readonly OptionsValidator $optionsValidator,
+    ) {}
+
+    public function key(): string
+    {
+        return 'jpg:webp';
+    }
+
+    public function sourceFormat(): string
+    {
+        return 'jpg';
+    }
+
+    public function targetFormat(): string
+    {
+        return 'webp';
+    }
+
+    public function label(): string
+    {
+        return 'WEBP';
+    }
+
+    public function description(): string
+    {
+        return 'Smaller modern image for websites';
+    }
+
+    public function optionsSchema(): array
+    {
+        return [
+            [
+                'key' => 'quality',
+                'type' => 'segmented',
+                'label' => 'Quality',
+                'default' => 'high',
+                'options' => [
+                    ['value' => 'medium', 'label' => 'Medium'],
+                    ['value' => 'high', 'label' => 'High'],
+                    ['value' => 'best', 'label' => 'Best'],
+                ],
+            ],
+            [
+                'key' => 'resize',
+                'type' => 'select',
+                'label' => 'Resize',
+                'default' => 'original',
+                'options' => [
+                    ['value' => 'original', 'label' => 'Original'],
+                    ['value' => '1920', 'label' => '1920 px'],
+                    ['value' => '1280', 'label' => '1280 px'],
+                    ['value' => 'custom', 'label' => 'Custom'],
+                ],
+            ],
+            [
+                'key' => 'remove_metadata',
+                'type' => 'toggle',
+                'label' => 'Remove metadata',
+                'default' => true,
+            ],
+        ];
+    }
+
+    public function validateOptions(array $options): array
+    {
+        return $this->optionsValidator->validate($this->optionsSchema(), $options);
+    }
+
+    public function isRecommended(): bool
+    {
+        return true;
+    }
+}