Merge branch 'main' into feat/form-layout-components

Author: Baspa

.github/workflows/fix-php-code-style-issues.yml

@@ -14,14 +14,14 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           ref: ${{ github.head_ref }}
 
       - name: Fix PHP code style issues
         uses: aglipanci/[email protected]
 
       - name: Commit changes
-        uses: stefanzweifel/git-auto-commit-action@v6
+        uses: stefanzweifel/git-auto-commit-action@v7
         with:
-          commit_message: Fix styling
+          commit_message: "styles: fix styling issues"

.github/workflows/phpstan.yml

@@ -11,12 +11,12 @@ jobs:
     name: phpstan
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.2'
+          php-version: '8.3'
           coverage: none
 
       - name: Install composer dependencies

.github/workflows/run-tests.yml

@@ -13,22 +13,18 @@ jobs:
       fail-fast: true
       matrix:
         os: [ubuntu-latest, windows-latest]
-        php: [8.3, 8.2]
-        laravel: [11.*]
-        stability: [prefer-lowest, prefer-stable]
+        php: [8.3]
+        laravel: [12.*]
         include:
-          - laravel: 11.*
-            testbench: 9.*
-            carbon: ^2.72.2
-        exclude:
-          - laravel: 11.*
-            php: 8.1
+          - laravel: 12.*
+            testbench: 10.*
+            carbon: 3.*
 
-    name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.stability }} - ${{ matrix.os }}
+    name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.os }}
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
@@ -45,10 +41,10 @@ jobs:
       - name: Install dependencies
         run: |
           composer require "laravel/framework:${{ matrix.laravel }}" "orchestra/testbench:${{ matrix.testbench }}" "nesbot/carbon:${{ matrix.carbon }}" --no-interaction --no-update
-          composer update --${{ matrix.stability }} --prefer-dist --no-interaction
+          composer update --prefer-dist --no-interaction
 
       - name: List Installed Dependencies
         run: composer show -D
 
       - name: Execute tests
-        run: vendor/bin/pest --ci
+        run: vendor/bin/pest --ci --no-coverage

.github/workflows/update-changelog.yml

@@ -13,7 +13,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           ref: main
 
@@ -24,7 +24,7 @@ jobs:
           release-notes: ${{ github.event.release.body }}
 
       - name: Commit updated CHANGELOG
-        uses: stefanzweifel/git-auto-commit-action@v6
+        uses: stefanzweifel/git-auto-commit-action@v7
         with:
           branch: main
           commit_message: Update CHANGELOG

README.md

@@ -83,6 +83,12 @@ return [
     'selectable_resources' => [
         // App\Filament\Resources\ContentResource::class,
     ],
+
+    // Models that can be used for visibility rules
+    'visibility_models' => [
+        // \App\Models\Content::class,
+        // Add any models you want to use in visibility conditions
+    ],
 ];
 ```
 
@@ -164,13 +170,113 @@ When no other fields are available for dependency rules, the field selection wil
 
 #### Visibility Rules
 
-Control when fields are shown or hidden based on conditions:
+Control when fields are shown or hidden based on conditions. The visibility system supports two types of conditions:
+
+##### Field-Based Conditions
+
+Show/hide fields based on other field values in the same form:
+
+-   **Field Selection**: Choose from available fields in the current form
+-   **Dynamic Options**: Field options update automatically based on available fields
+-   **Self-Exclusion**: Fields cannot reference themselves to prevent infinite loops
+
+##### Model Attribute Conditions
 
--   **Conditional Display**: Show/hide fields based on other field values
--   **Dynamic Forms**: Create adaptive forms that change based on user input
--   **Complex Logic**: Support for multiple conditions and logical operators
+Show/hide fields based on properties of the current record:
 
-The visibility system works seamlessly with validation rules to create intelligent, user-friendly forms.
+-   **Record Properties**: Access any attribute of the current model instance
+-   **Model Selection**: Choose from configured models in your application
+-   **Attribute Discovery**: Automatically discover available attributes from database schema
+
+##### Configuration
+
+To enable model attribute conditions, add your models to the `visibility_models` config array:
+
+```php
+return [
+    // ... other config
+
+    // Models that can be used for visibility rules
+    'visibility_models' => [
+        // \App\Models\Content::class,
+    ],
+];
+```
+
+##### Supported Operators
+
+The visibility system supports a comprehensive set of comparison operators:
+
+-   **Equality**: `equals`, `not_equals`
+-   **Text Operations**: `contains`, `not_contains`, `starts_with`, `ends_with`
+-   **Empty Checks**: `is_empty`, `is_not_empty`
+-   **Numeric Comparisons**: `greater_than`, `less_than`, `greater_than_or_equal`, `less_than_or_equal`
+-   **List Operations**: `in`, `not_in` (comma-separated values)
+
+##### Logical Operators
+
+Combine multiple conditions with logical operators:
+
+-   **AND Logic**: All conditions must be met for the field to be visible
+-   **OR Logic**: Any condition can be met for the field to be visible
+
+##### Example Use Cases
+
+**Content Type-Based Fields**:
+```json
+{
+  "logic": "AND",
+  "conditions": [
+    {
+      "source": "model_attribute",
+      "model": "App\\Models\\Content",
+      "property": "type_slug",
+      "operator": "equals",
+      "value": "article"
+    }
+  ]
+}
+```
+
+**Multi-Condition Logic**:
+```json
+{
+  "logic": "OR",
+  "conditions": [
+    {
+      "source": "model_attribute",
+      "model": "App\\Models\\Content",
+      "property": "status",
+      "operator": "equals",
+      "value": "published"
+    },
+    {
+      "source": "field",
+      "property": "field_ulid_here",
+      "operator": "equals",
+      "value": "draft"
+    }
+  ]
+}
+```
+
+**Hide on Specific Pages**:
+```json
+{
+  "logic": "AND",
+  "conditions": [
+    {
+      "source": "model_attribute",
+      "model": "App\\Models\\Content",
+      "property": "slug",
+      "operator": "not_equals",
+      "value": "home"
+    }
+  ]
+}
+```
+
+The visibility system works seamlessly with validation rules to create intelligent, user-friendly forms that adapt to your data and user interactions.
 
 ### Making a resource page configurable
 
@@ -382,6 +488,10 @@ The package includes a powerful Rich Editor with custom plugins:
 
 -   **[Jump Anchor Plugin](docs/jump-anchor-plugin.md)** - Add anchor links to selected text for navigation and jumping to specific sections
 
+### Field Configuration
+
+-   **[Visibility Rules](docs/visibility-rules.md)** - Comprehensive guide to controlling field visibility based on conditions and record properties
+
 ## Testing
 
 ```bash

composer.json

@@ -20,7 +20,7 @@
         }
     ],
     "require": {
-        "php": "^8.2",
+        "php": "^8.3",
         "baspa/laravel-timezones": "^1.2",
         "filament/filament": "^4.0",
         "saade/filament-adjacency-list": "^4.0",
@@ -32,9 +32,9 @@
         "nunomaduro/collision": "^8.1.1||^7.10.0",
         "nunomaduro/larastan": "^3.0",
         "orchestra/testbench": "^9.0.0",
-        "pestphp/pest": "^2.34",
-        "pestphp/pest-plugin-arch": "^2.0",
-        "pestphp/pest-plugin-laravel": "^2.0",
+        "pestphp/pest": "^4.1",
+        "pestphp/pest-plugin-arch": "^4.0",
+        "pestphp/pest-plugin-laravel": "^4.0",
         "phpstan/extension-installer": "^1.1",
         "phpstan/phpstan-deprecation-rules": "^2.0",
         "phpstan/phpstan-phpunit": "^2.0"
@@ -74,8 +74,6 @@
             }
         }
     },
-    "repositories": {
-    },
     "minimum-stability": "beta",
     "prefer-stable": true
 }

config/backstage/fields.php

@@ -21,4 +21,9 @@
     'selectable_resources' => [
         // App\Filament\Resources\ContentResource::class,
     ],
+
+    // Models that can be used for visibility rules
+    'visibility_models' => [
+        // \App\Models\Content::class,
+    ],
 ];

database/migrations/fix_option_type_string_values_in_fields_table.php.stub

@@ -0,0 +1,61 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        // Get all fields with config containing optionType
+        $fields = DB::table('fields')
+            ->whereNotNull('config')
+            ->where('config', 'like', '%optionType%')
+            ->get();
+
+        foreach ($fields as $field) {
+            $config = json_decode($field->config, true);
+            
+            if (isset($config['optionType']) && is_string($config['optionType'])) {
+                // Convert string to array format
+                $config['optionType'] = [$config['optionType']];
+                
+                // Update the field with the corrected config
+                DB::table('fields')
+                    ->where('ulid', $field->ulid)
+                    ->update(['config' => json_encode($config)]);
+            }
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        // Get all fields with config containing optionType arrays
+        $fields = DB::table('fields')
+            ->whereNotNull('config')
+            ->where('config', 'like', '%optionType%')
+            ->get();
+
+        foreach ($fields as $field) {
+            $config = json_decode($field->config, true);
+            
+            if (isset($config['optionType']) && is_array($config['optionType']) && count($config['optionType']) === 1) {
+                // Convert array back to string format
+                $config['optionType'] = $config['optionType'][0];
+                
+                // Update the field with the reverted config
+                DB::table('fields')
+                    ->where('ulid', $field->ulid)
+                    ->update(['config' => json_encode($config)]);
+            }
+        }
+    }
+};