optimize Enum and handle EnumHelpers

Author: Karim-Ashraf

CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- `EnumHelpers` trait providing `values()`, `options()`, `label()`, `is()` and `isNot()` to backed enums; any helper can be overridden by redeclaring it on the enum.
+
+### Changed
+
+- Generated enums now use the `EnumHelpers` trait instead of duplicating the helper methods in every enum class.
+
 ## [1.0.0] - 2026-07-21
 
 ### Added

README.md

@@ -141,7 +141,7 @@ A unique field automatically gets `Rule::unique(...)` in the store request and `
 
 ### Enum fields
 
-Declare a field as `enum` (e.g. `status:enum`) and, with the `enum` pattern enabled, the generator produces a string-backed enum class (`App\Enums\ProductStatus`) with `values()`, `options()` and `label()` helpers — and wires it through the whole module:
+Declare a field as `enum` (e.g. `status:enum`) and, with the `enum` pattern enabled, the generator produces a string-backed enum class (`App\Enums\ProductStatus`) that uses the package's `EnumHelpers` trait — giving it `values()`, `options()`, `label()`, `is()` and `isNot()` without any boilerplate. Override any helper by redeclaring it on the enum (e.g. a translated `label()`). The enum is wired through the whole module:
 
 - the model casts the attribute to the enum (`'status' => ProductStatus::class`)
 - the form requests validate it with `Rule::enum(ProductStatus::class)`

src/Enums/Concerns/EnumHelpers.php

@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KarimAshraf\LaraArchitect\Enums\Concerns;
+
+use Illuminate\Support\Str;
+
+/**
+ * Shared helpers for backed enums. Any method can be overridden by simply
+ * redeclaring it on the enum — a common case is a custom label():
+ *
+ *     enum ProductStatus: string
+ *     {
+ *         use EnumHelpers;
+ *
+ *         case Active = 'active';
+ *
+ *         public function label(): string
+ *         {
+ *             return __("statuses.{$this->value}");
+ *         }
+ *     }
+ */
+trait EnumHelpers
+{
+    /**
+     * All case values, e.g. for validation or database columns.
+     *
+     * @return list<string|int>
+     */
+    public static function values(): array
+    {
+        return array_column(self::cases(), 'value');
+    }
+
+    /**
+     * Value => label map, e.g. for select inputs.
+     *
+     * @return array<string|int, string>
+     */
+    public static function options(): array
+    {
+        return array_combine(
+            self::values(),
+            array_map(fn (self $case): string => $case->label(), self::cases()),
+        );
+    }
+
+    /**
+     * Human-readable label ("in_review" becomes "In Review").
+     */
+    public function label(): string
+    {
+        return Str::headline((string) $this->value);
+    }
+
+    public function is(self $other): bool
+    {
+        return $this === $other;
+    }
+
+    public function isNot(self $other): bool
+    {
+        return $this !== $other;
+    }
+}

stubs/enum.stub

@@ -2,40 +2,17 @@
 
 namespace {{ namespace }};
 
-use Illuminate\Support\Str;
+use KarimAshraf\LaraArchitect\Enums\Concerns\EnumHelpers;
 
 enum {{ class }}: string
 {
-    case Draft = 'draft';
-    case Active = 'active';
-    case Archived = 'archived';
-
     /**
-     * @return list<string>
+     * Provides values(), options(), label(), is() and isNot().
+     * Override any of them by redeclaring the method here.
      */
-    public static function values(): array
-    {
-        return array_column(self::cases(), 'value');
-    }
+    use EnumHelpers;
 
-    /**
-     * @return array<string, string>
-     */
-    public static function options(): array
-    {
-        return array_combine(
-            self::values(),
-            array_map(fn (self $case) => $case->label(), self::cases()),
-        );
-    }
-
-    public function label(): string
-    {
-        return Str::headline($this->value);
-    }
-
-    public function is(self $other): bool
-    {
-        return $this === $other;
-    }
+    case Draft = 'draft';
+    case Active = 'active';
+    case Archived = 'archived';
 }

tests/Feature/MakeModuleCommandTest.php

@@ -109,7 +109,8 @@ public function test_enum_fields_generate_enums_wired_into_the_module(): void
 
         $enum = File::get(app_path('Enums/ProductStatus.php'));
         $this->assertStringContainsString('enum ProductStatus: string', $enum);
-        $this->assertStringContainsString('public static function values(): array', $enum);
+        $this->assertStringContainsString('use KarimAshraf\LaraArchitect\Enums\Concerns\EnumHelpers;', $enum);
+        $this->assertStringContainsString('use EnumHelpers;', $enum);
 
         $model = File::get(app_path('Models/Product.php'));
         $this->assertStringContainsString('use App\Enums\ProductStatus;', $model);

tests/Fixtures/PostStatus.php

@@ -4,8 +4,12 @@
 
 namespace KarimAshraf\LaraArchitect\Tests\Fixtures;
 
+use KarimAshraf\LaraArchitect\Enums\Concerns\EnumHelpers;
+
 enum PostStatus: string
 {
+    use EnumHelpers;
+
     case Draft = 'draft';
     case Published = 'published';
 }

tests/Unit/EnumHelpersTest.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KarimAshraf\LaraArchitect\Tests\Unit;
+
+use KarimAshraf\LaraArchitect\Enums\Concerns\EnumHelpers;
+use KarimAshraf\LaraArchitect\Tests\Fixtures\PostStatus;
+use KarimAshraf\LaraArchitect\Tests\TestCase;
+
+enum ReviewState: string
+{
+    use EnumHelpers;
+
+    case InReview = 'in_review';
+    case Approved = 'approved';
+
+    public function label(): string
+    {
+        return strtoupper($this->value);
+    }
+}
+
+class EnumHelpersTest extends TestCase
+{
+    public function test_values_returns_all_case_values(): void
+    {
+        $this->assertSame(['draft', 'published'], PostStatus::values());
+    }
+
+    public function test_options_maps_values_to_headline_labels(): void
+    {
+        $this->assertSame(
+            ['draft' => 'Draft', 'published' => 'Published'],
+            PostStatus::options(),
+        );
+    }
+
+    public function test_is_and_is_not_compare_cases(): void
+    {
+        $this->assertTrue(PostStatus::Draft->is(PostStatus::Draft));
+        $this->assertFalse(PostStatus::Draft->is(PostStatus::Published));
+        $this->assertTrue(PostStatus::Draft->isNot(PostStatus::Published));
+        $this->assertFalse(PostStatus::Draft->isNot(PostStatus::Draft));
+    }
+
+    public function test_label_can_be_overridden_on_the_enum(): void
+    {
+        $this->assertSame('IN_REVIEW', ReviewState::InReview->label());
+        $this->assertSame(
+            ['in_review' => 'IN_REVIEW', 'approved' => 'APPROVED'],
+            ReviewState::options(),
+        );
+    }
+}