feat: Add enum value detection for model schema

- Detect PHP enum casts and include case values as enum:val1|val2|val3
- Parse SQL ENUM column definitions for native enum values
- PHP enum casts take priority over SQL ENUM definitions
- Added test coverage for PHP enum detection

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: leeoptima

src/Services/ModelSchemaService.php

@@ -157,24 +157,88 @@ protected function buildSchema(string $modelClass, int $depth, int $maxDepth, ar
     protected function getColumns(Model $model): array
     {
         $tableName = $this->getTableName($model->getTable());
+        $casts = $model->getCasts();
 
         return collect($this->getDatabaseColumns($tableName))
+            ->map(fn (array $info, string $column) => $this->applyEnumCast($info, $column, $casts))
             ->merge($this->getAccessors($model))
             ->all();
     }
 
+    /**
+     * Apply enum information to a column from PHP cast or SQL enum type.
+     */
+    protected function applyEnumCast(array $info, string $column, array $casts): array
+    {
+        // First priority: PHP enum cast
+        if (isset($casts[$column])) {
+            $castType = $casts[$column];
+
+            // Handle enum casts - could be class string or class:EnumClass format
+            $enumClass = $castType;
+            if (str_contains($castType, ':')) {
+                $enumClass = explode(':', $castType)[1] ?? $castType;
+            }
+
+            // Check if it's a backed enum
+            if (enum_exists($enumClass)) {
+                $reflection = new \ReflectionEnum($enumClass);
+                if ($reflection->isBacked()) {
+                    $cases = array_map(
+                        fn ($case) => $case->value,
+                        $enumClass::cases()
+                    );
+
+                    $info['type'] = 'enum:' . implode('|', $cases);
+                    $info['enum_class'] = $enumClass;
+
+                    return $info;
+                }
+            }
+        }
+
+        // Second priority: SQL ENUM type - parse values from type_raw
+        if (($info['type'] ?? '') === 'enum' && isset($info['type_raw'])) {
+            $sqlEnumValues = $this->parseSqlEnumValues($info['type_raw']);
+            if (! empty($sqlEnumValues)) {
+                $info['type'] = 'enum:' . implode('|', $sqlEnumValues);
+            }
+        }
+
+        return $info;
+    }
+
+    /**
+     * Parse SQL enum values from the raw type definition.
+     * e.g., "enum('draft','published','archived')" => ['draft', 'published', 'archived']
+     *
+     * @return array<string>
+     */
+    protected function parseSqlEnumValues(string $typeRaw): array
+    {
+        if (! preg_match("/^enum\s*\((.+)\)$/i", $typeRaw, $matches)) {
+            return [];
+        }
+
+        // Parse the comma-separated quoted values
+        preg_match_all("/'([^']+)'/", $matches[1], $valueMatches);
+
+        return $valueMatches[1] ?? [];
+    }
+
     /**
      * Get database columns for a table.
      */
     protected function getDatabaseColumns(string $tableName): Collection
     {
         try {
-            return collect(Schema::getColumnListing($tableName))
-                ->mapWithKeys(fn (string $column) => [
-                    $column => [
-                        'name' => $column,
-                        'type' => $this->getColumnType($tableName, $column),
-                        'type_icon' => $this->getTypeIcon($this->getColumnType($tableName, $column)),
+            return collect(Schema::getColumns($tableName))
+                ->mapWithKeys(fn (array $column) => [
+                    $column['name'] => [
+                        'name' => $column['name'],
+                        'type' => $column['type_name'],
+                        'type_raw' => $column['type'],
+                        'type_icon' => $this->getTypeIcon($column['type_name']),
                         'is_accessor' => false,
                     ],
                 ]);

tests/Feature/ModelSchemaServiceTest.php

@@ -120,3 +120,13 @@
     expect($fields)->toHaveKey('posts.id');
     expect($fields)->toHaveKey('posts.title');
 });
+
+it('detects enum casts and includes options', function () {
+    $service = app(ModelSchemaService::class);
+
+    $schema = $service->getSchema(Post::class);
+
+    expect($schema['columns'])->toHaveKey('status');
+    expect($schema['columns']['status']['type'])->toBe('enum:draft|published|archived');
+    expect($schema['columns']['status']['enum_class'])->toBe(\Visualbuilder\EloquentSchema\Tests\Fixtures\Enums\PostStatus::class);
+});

tests/Fixtures/Enums/PostStatus.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Visualbuilder\EloquentSchema\Tests\Fixtures\Enums;
+
+enum PostStatus: string
+{
+    case DRAFT = 'draft';
+    case PUBLISHED = 'published';
+    case ARCHIVED = 'archived';
+}

tests/Fixtures/Models/Post.php

@@ -8,6 +8,7 @@
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Visualbuilder\EloquentSchema\Tests\Fixtures\Enums\PostStatus;
 
 class Post extends Model
 {
@@ -16,12 +17,14 @@ class Post extends Model
         'title',
         'slug',
         'content',
+        'status',
         'published_at',
     ];
 
     protected function casts(): array
     {
         return [
+            'status' => PostStatus::class,
             'published_at' => 'datetime',
         ];
     }

tests/database/migrations/0001_01_01_000001_create_test_tables.php

@@ -15,6 +15,7 @@ public function up(): void
             $table->string('name');
             $table->string('email')->unique();
             $table->text('bio')->nullable();
+            $table->enum('account_type', ['free', 'premium', 'enterprise'])->default('free');
             $table->timestamps();
         });
 
@@ -24,6 +25,7 @@ public function up(): void
             $table->string('title');
             $table->string('slug')->unique();
             $table->text('content');
+            $table->string('status')->default('draft');
             $table->timestamp('published_at')->nullable();
             $table->timestamps();
         });