Refactor attachment cropping functionality to support multiple variants

- Introduced AttachmentCrop model to manage crop variants for attachments.
- Updated Attachment model to remove direct crop fields and establish relationships with AttachmentCrop.
- Modified AttachmentService to handle storing and updating multiple crop variants (desktop and mobile).
- Adjusted validation rules to accommodate new crop structure.
- Updated database migration to create attachment_crops table and migrate existing crop data.
- Refactored tests to ensure compatibility with the new cropping structure and validate multiple crop variants.
- Enhanced documentation to reflect changes in attachment handling and cropping capabilities.

app/Domains/Tenant/Resources/AdminApp/WebsiteExtrasResource.php

@@ -3,6 +3,7 @@
 namespace App\Domains\Tenant\Resources\AdminApp;
 
 use App\Domains\Attachable\Models\Attachment;
+use App\Domains\Attachable\Models\AttachmentCrop;
 use App\Domains\Tenant\Models\Tenant;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
@@ -70,16 +71,25 @@ class WebsiteExtrasResource extends JsonResource
     }
 
     /**
-     * @return array{url: string, crop_horizontal: array<string, float>, crop_vertical: array<string, float>}
+     * @return array{url: string, crops: array<string, array<string, array<string, float>>>}
      */
     private function formatHeroAttachment(Attachment $attachment): array
     {
         $fullRange = ['start_percentage' => 0.0, 'end_percentage' => 100.0];
+        $crops = $attachment->cropVariants->keyBy('variant');
 
         return [
             'url' => $attachment->getTemporaryUrl(1440),
-            'crop_horizontal' => $attachment->crop_horizontal ?? $fullRange,
-            'crop_vertical' => $attachment->crop_vertical ?? $fullRange,
+            'crops' => collect(AttachmentCrop::VARIANTS)->mapWithKeys(
+                function (string $variant) use ($crops, $fullRange): array {
+                    $crop = $crops->get($variant);
+
+                    return [$variant => [
+                        'crop_horizontal' => $crop?->crop_horizontal ?? $fullRange,
+                        'crop_vertical' => $crop?->crop_vertical ?? $fullRange,
+                    ]];
+                }
+            )->all(),
         ];
     }