Custom Fields 4.0 [4.x]

.github/instructions/filament.instructions.md

@@ -18,7 +18,7 @@ Do NOT flag `Filament\Schemas\Components\Component` as incorrect.
 
 - Custom field types live in `src/FieldTypeSystem/Definitions/`
 - Validation capabilities live in `src/Validation/Capabilities/`
-- Each capability implements `Relaticle\CustomFields\Contracts\ValidationCapability`
+- Each capability implements `Relaticle\CustomFields\Contracts\ValidationCapabilityInterface`
 - `DateConstraintValue` is a Spatie Laravel Data class -- use `::from()` for hydration, not manual construction
 
 # Data Patterns

.github/workflows/docs.yml

@@ -4,7 +4,7 @@ name: Docs
 # caught on the pull request instead of after the merge, when only the deploy runs.
 on:
   pull_request:
-    branches: [3.x]
+    branches: [3.x, 4.x]
 
 permissions:
   contents: read

.github/workflows/tests.yml

@@ -2,9 +2,9 @@ name: Tests
 
 on:
   push:
-    branches: [3.x]
+    branches: [3.x, 4.x]
   pull_request:
-    branches: [3.x]
+    branches: [3.x, 4.x]
   workflow_call:
 
 permissions:
@@ -41,18 +41,57 @@ jobs:
   tests:
     runs-on: ubuntu-latest
     strategy:
-      fail-fast: true
+      fail-fast: false
       matrix:
         php: [8.4]
         laravel: [12.*, 13.*]
         stability: [prefer-stable]
+        db: [sqlite, pgsql, mysql]
+        flavor: [polished]
         include:
           - laravel: 12.*
             testbench: 10.*
           - laravel: 13.*
             testbench: 11.*
+          # The forked UI surfaces render twice, so one leg reads them in the other flavor.
+          # A flavor no base combination carries adds a leg rather than converting one, and an
+          # earlier include never reaches a combination a later one creates, so it spells out
+          # every key it needs.
+          - php: 8.4
+            laravel: 13.*
+            stability: prefer-stable
+            db: sqlite
+            flavor: native
+            testbench: 11.*
 
-    name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }}
+    name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.db }} - ${{ matrix.flavor }}
+
+    services:
+      postgres:
+        image: postgres:17
+        env:
+          POSTGRES_USER: root
+          POSTGRES_PASSWORD: password
+          POSTGRES_DB: custom_fields_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd="pg_isready"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_ALLOW_EMPTY_PASSWORD: yes
+          MYSQL_DATABASE: custom_fields_test
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
 
     steps:
       - name: Checkout code
@@ -62,7 +101,7 @@ jobs:
         uses: shivammathur/setup-php@f3e473d116dcccaddc5834248c87452386958240 # 2.37.2
         with:
           php-version: ${{ matrix.php }}
-          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
+          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, pdo_pgsql, pgsql, pdo_mysql, mysqli, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
           coverage: none
 
       - name: Install dependencies
@@ -80,6 +119,14 @@ jobs:
         run: vendor/bin/rector --dry-run --no-progress-bar
 
       - name: Run Pest
+        env:
+          DB_CONNECTION: ${{ matrix.db }}
+          DB_HOST: 127.0.0.1
+          DB_PORT: ${{ matrix.db == 'pgsql' && '5432' || '3306' }}
+          DB_DATABASE: custom_fields_test
+          DB_USERNAME: root
+          DB_PASSWORD: ${{ matrix.db == 'pgsql' && 'password' || '' }}
+          CUSTOM_FIELDS_UI_FLAVOR: ${{ matrix.flavor }}
         run: vendor/bin/pest --ci
 
   gate:

README.md

@@ -13,6 +13,8 @@ A powerful Laravel/Filament plugin for adding dynamic custom fields to any Eloqu
 ## Features
 
 - **20+ Field Types** - Text, date, select, file upload, rich editor, and more
+- **Record Links** - Link records to records, one-way or paired, stored in an edge ledger
+- **Workflow States** - Status fields whose options carry a machine-readable category
 - **Conditional Visibility** - Show/hide fields based on other field values
 - **Multi-tenancy** - Complete tenant isolation and context management
 - **Filament Integration** - Forms, tables, infolists, and admin interface