feat: form schema components

database/migrations/add_schema_id_to_fields_table.php.stub

@@ -0,0 +1,24 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up()
+    {
+        Schema::table('fields', function (Blueprint $table) {
+            $table->ulid('schema_id')->nullable()->after('group');
+            $table->foreign('schema_id')->references('ulid')->on('schemas')->onDelete('set null');
+        });
+    }
+
+    public function down()
+    {
+        Schema::table('fields', function (Blueprint $table) {
+            $table->dropForeign(['schema_id']);
+            $table->dropColumn('schema_id');
+        });
+    }
+};

database/migrations/create_schemas_table.php.stub

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('schemas', function (Blueprint $table) {
+            $table->ulid('ulid')->primary();
+            $table->string('name');
+            $table->string('slug');
+            $table->string('field_type');
+            $table->json('config')->nullable();
+            $table->integer('position')->default(0);
+            $table->string('model_type');
+            $table->string('model_key');
+            $table->ulid('parent_ulid')->nullable();
+            $table->timestamps();
+
+            $table->index(['model_type', 'model_key']);
+            $table->index(['model_type', 'model_key', 'position']);
+            $table->index(['parent_ulid']);
+
+            $table->unique(['model_type', 'model_key', 'slug']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('schemas');
+    }
+};

src/Concerns/CanMapDynamicFields.php

@@ -56,15 +56,11 @@ trait CanMapDynamicFields
         'tags' => Tags::class,
     ];
 
-    public function boot(): void
-    {
-        $this->fieldInspector = app(FieldInspector::class);
-    }
-
     #[On('refreshFields')]
-    public function refresh(): void
+    #[On('refreshSchemas')]
+    public function refreshFields(): void
     {
-        //
+        // Custom refresh logic for fields
     }
 
     /**
@@ -123,17 +119,21 @@ protected function mutateBeforeSave(array $data): array
 
     private function hasValidRecordWithFields(): bool
     {
-        return isset($this->record) && ! $this->record->fields->isEmpty();
+        return property_exists($this, 'record') && isset($this->record) && ! $this->record->fields->isEmpty();
     }
 
     private function hasValidRecord(): bool
     {
-        return isset($this->record);
+        return property_exists($this, 'record') && isset($this->record);
     }
 
     private function extractFormValues(array $data): array
     {
-        return isset($data[$this->record?->valueColumn]) ? $data[$this->record?->valueColumn] : [];
+        if (! property_exists($this, 'record') || ! $this->record) {
+            return [];
+        }
+
+        return isset($data[$this->record->valueColumn]) ? $data[$this->record->valueColumn] : [];
     }
 
     /**
@@ -165,6 +165,10 @@ private function extractBuilderBlocks(array $values): array
      */
     private function getAllFieldsIncludingBuilderFields(array $builderBlocks): Collection
     {
+        if (! property_exists($this, 'record') || ! $this->record) {
+            return collect();
+        }
+
         return $this->record->fields->merge(
             $this->getFieldsFromBlocks($builderBlocks)
         );
@@ -189,11 +193,17 @@ private function applyFieldFillMutation(Model $field, array $fieldConfig, object
                 return $this->processBuilderFieldFillMutation($field, $fieldInstance, $data, $fieldLocation['builderData'], $builderBlocks);
             }
 
-            return $fieldInstance->mutateFormDataCallback($this->record, $field, $data);
+            if (property_exists($this, 'record') && $this->record) {
+                return $fieldInstance->mutateFormDataCallback($this->record, $field, $data);
+            }
+
+            return $data;
         }
 
         // Default behavior: copy value from record to form data
-        $data[$this->record->valueColumn][$field->ulid] = $this->record->values[$field->ulid] ?? null;
+        if (property_exists($this, 'record') && $this->record) {
+            $data[$this->record->valueColumn][$field->ulid] = $this->record->values[$field->ulid] ?? null;
+        }
 
         return $data;
     }
@@ -205,7 +215,7 @@ private function applyFieldFillMutation(Model $field, array $fieldConfig, object
      */
     private function extractBuilderBlocksFromRecord(): array
     {
-        if (! isset($this->record->values) || ! is_array($this->record->values)) {
+        if (! property_exists($this, 'record') || ! $this->record || ! isset($this->record->values) || ! is_array($this->record->values)) {
             return [];
         }
 
@@ -235,14 +245,20 @@ private function processBuilderFieldFillMutation(Model $field, object $fieldInst
         $mockRecord = $this->createMockRecordForBuilder($builderData);
 
         // Create a temporary data structure for the callback
-        $tempData = [$this->record->valueColumn => $builderData];
-        $tempData = $fieldInstance->mutateFormDataCallback($mockRecord, $field, $tempData);
+        if (property_exists($this, 'record') && $this->record) {
+            $tempData = [$this->record->valueColumn => $builderData];
+            $tempData = $fieldInstance->mutateFormDataCallback($mockRecord, $field, $tempData);
+        } else {
+            $tempData = [];
+        }
 
         // Update the original data structure with the mutated values
         $this->updateBuilderBlocksWithMutatedData($builderBlocks, $field, $tempData);
 
         // Update the main data structure
-        $data[$this->record->valueColumn] = array_merge($data[$this->record->valueColumn], $builderBlocks);
+        if (property_exists($this, 'record') && $this->record) {
+            $data[$this->record->valueColumn] = array_merge($data[$this->record->valueColumn], $builderBlocks);
+        }
 
         return $data;
     }
@@ -255,6 +271,9 @@ private function processBuilderFieldFillMutation(Model $field, object $fieldInst
      */
     private function createMockRecordForBuilder(array $builderData): object
     {
+        if (! property_exists($this, 'record') || ! $this->record) {
+            throw new \RuntimeException('Record property is not available');
+        }
         $mockRecord = clone $this->record;
         $mockRecord->values = $builderData;
 
@@ -274,7 +293,9 @@ private function updateBuilderBlocksWithMutatedData(array &$builderBlocks, Model
             if (is_array($builderBlocks)) {
                 foreach ($builderBlocks as &$block) {
                     if (isset($block['data']) && is_array($block['data']) && isset($block['data'][$field->ulid])) {
-                        $block['data'][$field->ulid] = $tempData[$this->record->valueColumn][$field->ulid] ?? $block['data'][$field->ulid];
+                        if (property_exists($this, 'record') && $this->record) {
+                            $block['data'][$field->ulid] = $tempData[$this->record->valueColumn][$field->ulid] ?? $block['data'][$field->ulid];
+                        }
                     }
                 }
             }
@@ -292,6 +313,11 @@ private function updateBuilderBlocksWithMutatedData(array &$builderBlocks, Model
      */
     private function resolveFieldConfigAndInstance(Model $field): array
     {
+        // Initialize field inspector if not already done
+        if (! isset($this->fieldInspector)) {
+            $this->fieldInspector = app(FieldInspector::class);
+        }
+
         // Try to resolve from custom fields first
         $fieldConfig = Fields::resolveField($field->field_type) ?
             $this->fieldInspector->initializeCustomField($field->field_type) :
@@ -391,9 +417,9 @@ private function processNestedFields(Model $field, array $data, callable $mutati
      */
     private function resolveFormFields(mixed $record = null, bool $isNested = false): array
     {
-        $record = $record ?? $this->record;
+        $record = $record ?? (property_exists($this, 'record') ? $this->record : null);
 
-        if (! isset($record->fields) || $record->fields->isEmpty()) {
+        if (! $record || ! isset($record->fields) || $record->fields->isEmpty()) {
             return [];
         }
 
@@ -409,7 +435,7 @@ private function resolveFormFields(mixed $record = null, bool $isNested = false)
     private function resolveCustomFields(): Collection
     {
         return collect(Fields::getFields())
-            ->map(fn ($fieldClass) => new $fieldClass);
+            ->mapWithKeys(fn ($fieldClass, $key) => [$key => $fieldClass]);
     }
 
     /**
@@ -426,26 +452,36 @@ private function resolveCustomFields(): Collection
      */
     private function resolveFieldInput(Model $field, Collection $customFields, mixed $record = null, bool $isNested = false): ?object
     {
-        $record = $record ?? $this->record;
+        $record = $record ?? (property_exists($this, 'record') ? $this->record : null);
+
+        if (! $record) {
+            return null;
+        }
 
         $inputName = $this->generateInputName($field, $record, $isNested);
 
         // Try to resolve from custom fields first (giving them priority)
-        if ($customField = $customFields->get($field->field_type)) {
-            return $customField::make($inputName, $field);
+        if ($customFieldClass = $customFields->get($field->field_type)) {
+            $input = $customFieldClass::make($inputName, $field);
+
+            return $input;
         }
 
         // Fall back to standard field type map if no custom field found
         if ($fieldClass = self::FIELD_TYPE_MAP[$field->field_type] ?? null) {
-            return $fieldClass::make(name: $inputName, field: $field);
+            $input = $fieldClass::make(name: $inputName, field: $field);
+
+            return $input;
         }
 
         return null;
     }
 
     private function generateInputName(Model $field, mixed $record, bool $isNested): string
     {
-        return $isNested ? "{$field->ulid}" : "{$record->valueColumn}.{$field->ulid}";
+        $name = $isNested ? "{$field->ulid}" : "{$record->valueColumn}.{$field->ulid}";
+
+        return $name;
     }
 
     /**
@@ -474,7 +510,11 @@ private function applyFieldSaveMutation(Model $field, array $fieldConfig, object
         }
 
         // Regular field processing
-        return $fieldInstance->mutateBeforeSaveCallback($this->record, $field, $data);
+        if (property_exists($this, 'record') && $this->record) {
+            return $fieldInstance->mutateBeforeSaveCallback($this->record, $field, $data);
+        }
+
+        return $data;
     }
 
     /**
@@ -532,18 +572,22 @@ private function processBuilderFieldMutation(Model $field, object $fieldInstance
                         $mockRecord = $this->createMockRecordForBuilder($block['data']);
 
                         // Create a temporary data structure for the callback
-                        $tempData = [$this->record->valueColumn => $block['data']];
-                        $tempData = $fieldInstance->mutateBeforeSaveCallback($mockRecord, $field, $tempData);
+                        if (property_exists($this, 'record') && $this->record) {
+                            $tempData = [$this->record->valueColumn => $block['data']];
+                            $tempData = $fieldInstance->mutateBeforeSaveCallback($mockRecord, $field, $tempData);
 
-                        if (isset($tempData[$this->record->valueColumn][$field->ulid])) {
-                            $block['data'][$field->ulid] = $tempData[$this->record->valueColumn][$field->ulid];
+                            if (isset($tempData[$this->record->valueColumn][$field->ulid])) {
+                                $block['data'][$field->ulid] = $tempData[$this->record->valueColumn][$field->ulid];
+                            }
                         }
                     }
                 }
             }
         }
 
-        $data[$this->record->valueColumn] = array_merge($data[$this->record->valueColumn], $builderBlocks);
+        if (property_exists($this, 'record') && $this->record) {
+            $data[$this->record->valueColumn] = array_merge($data[$this->record->valueColumn], $builderBlocks);
+        }
 
         return $data;
     }