fix: backed enum support

Author: jorisnoo

README.md

@@ -44,12 +44,22 @@ When `IMAGEBOSS_SOURCE` is not set, the package falls back to Statamic's Glide.
 
 ### Presets
 
-| Preset | Min | Max | Ratio | Interval |
-|--------|-----|-----|-------|----------|
-| default | 320 | 2560 | - | 200 |
-| thumbnail | 200 | 700 | 1:1 | 250 |
-| card | 300 | 800 | 4:5 | 200 |
-| hero | 640 | 3840 | - | 200 |
+Define presets in `config/statamic-imageboss.php`:
+
+```php
+'presets' => [
+    'thumbnail' => [
+        'min' => 200,      // minimum srcset width
+        'max' => 700,      // maximum srcset width
+        'ratio' => 1,      // aspect ratio (optional)
+        'interval' => 250, // width step (optional)
+    ],
+    'hero' => [
+        'min' => 640,
+        'max' => 3840,
+    ],
+],
+```
 
 ## Usage
 
@@ -80,15 +90,13 @@ Full example:
 
 ```php
 use Noo\StatamicImageboss\Facades\ImageBoss;
-use Noo\StatamicImageboss\Preset;
 
 // Single URL
 $url = ImageBoss::from($asset)->width(800)->url();
 $url = ImageBoss::from($asset)->width(800)->ratio(16/9)->url();
 
-// Responsive srcset
+// Responsive srcset with preset
 $srcset = ImageBoss::from($asset)->preset('hero')->srcsetString();
-$srcset = ImageBoss::from($asset)->preset(Preset::Card)->srcsetString();
 
 // Custom configuration
 $srcset = ImageBoss::from($asset)
@@ -99,6 +107,18 @@ $srcset = ImageBoss::from($asset)
     ->srcsetString();
 ```
 
+For type safety, create a backed enum matching your config presets:
+
+```php
+enum Preset: string
+{
+    case Hero = 'hero';
+    case Thumbnail = 'thumbnail';
+}
+
+$srcset = ImageBoss::from($asset)->preset(Preset::Hero)->srcsetString();
+```
+
 ### Builder Methods
 
 | Method | Description |
@@ -109,7 +129,7 @@ $srcset = ImageBoss::from($asset)
 | `min(int)` | Minimum width for srcset |
 | `max(int)` | Maximum width for srcset |
 | `interval(int)` | Width step for srcset |
-| `preset(string\|Preset)` | Apply preset configuration |
+| `preset(string)` | Apply preset configuration |
 | `url()` | Generate single URL |
 | `srcset()` | Generate srcset array |
 | `srcsetString()` | Generate srcset string |

src/ImageBossBuilder.php

@@ -70,13 +70,10 @@ public function interval(int $interval): self
         return $this;
     }
 
-    public function preset(Preset|string $preset): self
+    public function preset(\BackedEnum|string $preset): self
     {
-        if ($preset instanceof Preset) {
-            $config = $preset->config();
-        } else {
-            $config = config("statamic-imageboss.presets.{$preset}", []);
-        }
+        $presetName = $preset instanceof \BackedEnum ? $preset->value : $preset;
+        $config = config("statamic-imageboss.presets.{$presetName}", []);
 
         if (empty($config)) {
             return $this;

src/Preset.php

@@ -2,7 +2,12 @@
 
 use Noo\StatamicImageboss\ImageBoss;
 use Noo\StatamicImageboss\ImageBossBuilder;
-use Noo\StatamicImageboss\Preset;
+
+enum TestPreset: string
+{
+    case Card = 'card';
+    case Thumbnail = 'thumbnail';
+}
 
 beforeEach(function () {
     config()->set('statamic-imageboss.source', 'test-source');
@@ -172,10 +177,10 @@ function createMockAsset(bool $hasFocus = false, ?string $focusValue = null): Mo
     expect($url)->toContain('width/500');
 });
 
-it('accepts Preset enum for type-safe preset selection', function () {
+it('accepts backed enum for type-safe preset selection', function () {
     $asset = createMockAsset();
 
-    $builder = (new ImageBossBuilder($asset))->preset(Preset::Card);
+    $builder = (new ImageBossBuilder($asset))->preset(TestPreset::Card);
 
     $srcset = $builder->srcset();
 
@@ -184,27 +189,20 @@ function createMockAsset(bool $hasFocus = false, ?string $focusValue = null): Mo
     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 () {
+it('applies ratio from preset', function () {
     $asset = createMockAsset();
 
-    $builder = (new ImageBossBuilder($asset))->preset(Preset::Thumbnail)->width(400);
+    $builder = (new ImageBossBuilder($asset))->preset('thumbnail')->width(400);
 
     $url = $builder->url();
 
     expect($url)->toContain('cover/400x400');
 });
 
-it('applies interval from Preset enum', function () {
+it('applies interval from preset', function () {
     $asset = createMockAsset();
 
-    $builder = (new ImageBossBuilder($asset))->preset(Preset::Thumbnail);
+    $builder = (new ImageBossBuilder($asset))->preset('thumbnail');
 
     $srcset = $builder->srcset();
     $widths = array_column($srcset, 'width');