feat: form schema components

.github/workflows/run-tests.yml

@@ -14,11 +14,11 @@ jobs:
       matrix:
         os: [ubuntu-latest, windows-latest]
         php: [8.3]
-        laravel: [12.*]
+        laravel: [11.*]
         include:
-          - laravel: 12.*
-            testbench: 10.*
-            carbon: 3.*
+          - laravel: 11.*
+            testbench: 9.*
+            carbon: 2.*|3.*
 
     name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.os }}
 

composer.json

@@ -31,10 +31,10 @@
         "laravel/pint": "^1.14",
         "nunomaduro/collision": "^8.1.1||^7.10.0",
         "nunomaduro/larastan": "^3.0",
-        "orchestra/testbench": "^9.0.0",
-        "pestphp/pest": "^4.1",
-        "pestphp/pest-plugin-arch": "^4.0",
-        "pestphp/pest-plugin-laravel": "^4.0",
+        "orchestra/testbench": "^9.0.0|^10.0",
+        "pestphp/pest": "^3.0|^4.0",
+        "pestphp/pest-plugin-arch": "^3.0|^4.0",
+        "pestphp/pest-plugin-laravel": "^3.0|^4.0",
         "phpstan/extension-installer": "^1.1",
         "phpstan/phpstan-deprecation-rules": "^2.0",
         "phpstan/phpstan-phpunit": "^2.0"

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');
+    }
+};

database/migrations/migrate_model_type_to_class_names.php.stub

@@ -0,0 +1,90 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        // Migrate old 'setting' model_type to actual class names
+        // This ensures backward compatibility for fields created before the PR
+
+        $fields = DB::table('fields')
+            ->where('model_type', 'setting')
+            ->get();
+
+        foreach ($fields as $field) {
+            // Try to determine the actual model class
+            // You may need to customize this logic based on your application
+            $modelClass = $this->resolveModelClass($field);
+
+            if ($modelClass) {
+                DB::table('fields')
+                    ->where('ulid', $field->ulid)
+                    ->update(['model_type' => $modelClass]);
+            }
+        }
+
+        // Do the same for schemas table if it exists
+        if (DB::getSchemaBuilder()->hasTable('schemas')) {
+            $schemas = DB::table('schemas')
+                ->where('model_type', 'setting')
+                ->get();
+
+            foreach ($schemas as $schema) {
+                $modelClass = $this->resolveModelClass($schema);
+
+                if ($modelClass) {
+                    DB::table('schemas')
+                        ->where('ulid', $schema->ulid)
+                        ->update(['model_type' => $modelClass]);
+                }
+            }
+        }
+    }
+
+    public function down(): void
+    {
+        // Revert to 'setting' for fields that were migrated
+        // This is a simple revert - you may want to customize based on your needs
+
+        DB::table('fields')
+            ->where('model_type', 'like', '%\\\\%') // Contains namespace separator
+            ->update(['model_type' => 'setting']);
+
+        if (DB::getSchemaBuilder()->hasTable('schemas')) {
+            DB::table('schemas')
+                ->where('model_type', 'like', '%\\\\%')
+                ->update(['model_type' => 'setting']);
+        }
+    }
+
+    /**
+     * Resolve the actual model class from the field/schema record
+     * 
+     * Customize this method based on your application's model structure
+     */
+    private function resolveModelClass(object $record): ?string
+    {
+        // Check if model_key matches common patterns
+        // This is a basic example - adjust to your app's structure
+
+        // If you have a specific model that fields/schemas attach to, use it
+        // For example, if all fields belong to forms:
+        if (class_exists('App\\Models\\Form')) {
+            return 'App\\Models\\Form';
+        }
+
+        // If you have a settings model:
+        if (class_exists('App\\Models\\Setting')) {
+            return 'App\\Models\\Setting';
+        }
+
+        // Try to infer from model_key if it contains model information
+        // You may need to add custom logic here based on your app
+
+        // Return null if we can't determine - will skip this record
+        return null;
+    }
+};

database/migrations/migrate_repeater_table_config_to_table_mode.php.stub

@@ -0,0 +1,67 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        // Migrate repeater fields from 'table' config to 'tableMode'
+        // This ensures backward compatibility
+
+        $repeaterFields = DB::table('fields')
+            ->where('field_type', 'repeater')
+            ->whereNotNull('config')
+            ->get();
+
+        foreach ($repeaterFields as $field) {
+            $config = json_decode($field->config, true);
+
+            if (! is_array($config)) {
+                continue;
+            }
+
+            // If 'table' config exists and 'tableMode' doesn't, migrate it
+            if (isset($config['table']) && ! isset($config['tableMode'])) {
+                $config['tableMode'] = $config['table'];
+
+                // Optionally remove the old 'table' key to clean up
+                // Uncomment the next line if you want to remove the old key
+                // unset($config['table']);
+
+                DB::table('fields')
+                    ->where('ulid', $field->ulid)
+                    ->update(['config' => json_encode($config)]);
+            }
+        }
+    }
+
+    public function down(): void
+    {
+        // Revert 'tableMode' back to 'table' for backward compatibility
+
+        $repeaterFields = DB::table('fields')
+            ->where('field_type', 'repeater')
+            ->whereNotNull('config')
+            ->get();
+
+        foreach ($repeaterFields as $field) {
+            $config = json_decode($field->config, true);
+
+            if (! is_array($config)) {
+                continue;
+            }
+
+            // If 'tableMode' exists, migrate it back to 'table'
+            if (isset($config['tableMode'])) {
+                $config['table'] = $config['tableMode'];
+                unset($config['tableMode']);
+
+                DB::table('fields')
+                    ->where('ulid', $field->ulid)
+                    ->update(['config' => json_encode($config)]);
+            }
+        }
+    }
+};