feat: preset enum

Author: jorisnoo

src/ImageBossBuilder.php

@@ -70,29 +70,32 @@ public function interval(int $interval): self
         return $this;
     }
 
-    public function preset(string $name): self
+    public function preset(Preset|string $preset): self
     {
-        $presets = config('statamic-imageboss.presets', []);
-        $preset = $presets[$name] ?? null;
+        if ($preset instanceof Preset) {
+            $config = $preset->config();
+        } else {
+            $config = config("statamic-imageboss.presets.{$preset}", []);
+        }
 
-        if (! $preset) {
+        if (empty($config)) {
             return $this;
         }
 
-        if (isset($preset['min'])) {
-            $this->min = $preset['min'];
+        if (isset($config['min'])) {
+            $this->min = $config['min'];
         }
 
-        if (isset($preset['max'])) {
-            $this->max = $preset['max'];
+        if (isset($config['max'])) {
+            $this->max = $config['max'];
         }
 
-        if (isset($preset['ratio'])) {
-            $this->ratio = $preset['ratio'];
+        if (isset($config['ratio'])) {
+            $this->ratio = $config['ratio'];
         }
 
-        if (isset($preset['interval'])) {
-            $this->interval = $preset['interval'];
+        if (isset($config['interval'])) {
+            $this->interval = $config['interval'];
         }
 
         return $this;

src/Preset.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Noo\StatamicImageboss;
+
+enum Preset: string
+{
+    case Default = 'default';
+    case Thumbnail = 'thumbnail';
+    case Card = 'card';
+    case Hero = 'hero';
+
+    /**
+     * @return array{min: int, max: int, ratio?: float, interval?: int}
+     */
+    public function config(): array
+    {
+        return match ($this) {
+            self::Default => ['min' => 320, 'max' => 2560],
+            self::Thumbnail => ['min' => 200, 'max' => 700, 'ratio' => 1, 'interval' => 250],
+            self::Card => ['min' => 300, 'max' => 800, 'ratio' => 4 / 5],
+            self::Hero => ['min' => 640, 'max' => 3840],
+        };
+    }
+}

tests/ImageBossBuilderTest.php

@@ -2,6 +2,7 @@
 
 use Noo\StatamicImageboss\ImageBoss;
 use Noo\StatamicImageboss\ImageBossBuilder;
+use Noo\StatamicImageboss\Preset;
 
 beforeEach(function () {
     config()->set('statamic-imageboss.source', 'test-source');
@@ -170,3 +171,43 @@ function createMockAsset(bool $hasFocus = false, ?string $focusValue = null): Mo
 
     expect($url)->toContain('width/500');
 });
+
+it('accepts Preset enum for type-safe preset selection', function () {
+    $asset = createMockAsset();
+
+    $builder = (new ImageBossBuilder($asset))->preset(Preset::Card);
+
+    $srcset = $builder->srcset();
+
+    expect($srcset)->toBeArray();
+    expect($srcset[0]['width'])->toBe(300);
+    expect(end($srcset)['width'])->toBe(800);
+});
+
+it('Preset enum has correct configuration for each case', function () {
+    expect(Preset::Default->config())->toBe(['min' => 320, 'max' => 2560]);
+    expect(Preset::Thumbnail->config())->toBe(['min' => 200, 'max' => 700, 'ratio' => 1, 'interval' => 250]);
+    expect(Preset::Card->config())->toBe(['min' => 300, 'max' => 800, 'ratio' => 4 / 5]);
+    expect(Preset::Hero->config())->toBe(['min' => 640, 'max' => 3840]);
+});
+
+it('applies ratio from Preset enum', function () {
+    $asset = createMockAsset();
+
+    $builder = (new ImageBossBuilder($asset))->preset(Preset::Thumbnail)->width(400);
+
+    $url = $builder->url();
+
+    expect($url)->toContain('cover/400x400');
+});
+
+it('applies interval from Preset enum', function () {
+    $asset = createMockAsset();
+
+    $builder = (new ImageBossBuilder($asset))->preset(Preset::Thumbnail);
+
+    $srcset = $builder->srcset();
+    $widths = array_column($srcset, 'width');
+
+    expect($widths)->toBe([200, 450, 700]);
+});