Merge pull request #88 from Relaticle/feat/scoped-management-feature

feat: add scoped management feature and section form extensibility

Author: ManukMinasyan

src/EntitySystem/EntityCollection.php

@@ -52,6 +52,14 @@ public function withCustomFields(): static
         );
     }
 
+    /**
+     * Get entities with custom fields that are globally managed (not scoped to a parent record)
+     */
+    public function globallyManaged(): static
+    {
+        return $this->withCustomFields()->withoutFeature(EntityFeature::SCOPED_MANAGEMENT->value);
+    }
+
     /**
      * Get entities that can be used as lookup sources
      */

src/Enums/EntityFeature.php

@@ -13,12 +13,14 @@ enum EntityFeature: string implements HasLabel
 {
     case CUSTOM_FIELDS = 'custom_fields';
     case LOOKUP_SOURCE = 'lookup_source';
+    case SCOPED_MANAGEMENT = 'scoped_management';
 
     public function getLabel(): string
     {
         return match ($this) {
             self::CUSTOM_FIELDS => 'Custom Fields',
             self::LOOKUP_SOURCE => 'Lookup Source',
+            self::SCOPED_MANAGEMENT => 'Scoped Management',
         };
     }
 
@@ -27,6 +29,7 @@ public function description(): string
         return match ($this) {
             self::CUSTOM_FIELDS => 'Entity can have custom fields attached',
             self::LOOKUP_SOURCE => 'Entity can be used as a lookup source for choice fields',
+            self::SCOPED_MANAGEMENT => 'Entity custom fields are managed per-parent record, not on the global management page',
         };
     }
 }

src/Facades/Entities.php

@@ -86,6 +86,14 @@ public static function withCustomFields(): EntityCollection
         return static::getEntities()->withCustomFields();
     }
 
+    /**
+     * Get entities with custom fields that are globally managed
+     */
+    public static function globallyManaged(): EntityCollection
+    {
+        return static::getEntities()->globallyManaged();
+    }
+
     /**
      * Get entities that can be used as lookup sources
      */
@@ -97,11 +105,13 @@ public static function asLookupSources(): EntityCollection
     /**
      * Get entities as options array
      */
-    public static function getOptions(bool $onlyCustomFields = true, bool $usePlural = true): array
+    public static function getOptions(bool $onlyCustomFields = true, bool $usePlural = true, bool $onlyGloballyManaged = false): array
     {
-        $entities = $onlyCustomFields
-            ? static::withCustomFields()
-            : static::getEntities();
+        $entities = match (true) {
+            $onlyGloballyManaged => static::globallyManaged(),
+            $onlyCustomFields => static::withCustomFields(),
+            default => static::getEntities(),
+        };
 
         return $entities->sortedByLabel()->toOptions($usePlural);
     }

src/Filament/Integration/Base/AbstractFormComponent.php

@@ -66,7 +66,7 @@ protected function configure(
                     filled($state)
             )
             ->required($this->validationService->isRequired($customField))
-            ->rules($this->validationService->getValidationRules($customField))
+            ->rules($this->getFieldValidationRules($customField))
             ->columnSpan($customField->width->getSpanValue())
             ->when(
                 FeatureManager::isEnabled(CustomFieldsFeature::FIELD_CONDITIONAL_VISIBILITY) &&
@@ -123,6 +123,12 @@ private function applyVisibility(
             : $field->live()->visibleJs($jsExpression);
     }
 
+    /** @return array<int, mixed> */
+    protected function getFieldValidationRules(CustomField $customField): array
+    {
+        return $this->validationService->getValidationRules($customField);
+    }
+
     /**
      * Apply settings dynamically to any Filament component
      */

src/Filament/Management/Pages/CustomFieldsManagementPage.php

@@ -43,7 +43,7 @@ class CustomFieldsManagementPage extends Page
     public function mount(): void
     {
         if (blank($this->currentEntityType)) {
-            $firstEntity = Entities::withCustomFields()->first();
+            $firstEntity = Entities::globallyManaged()->first();
             $this->setCurrentEntityType($firstEntity?->getAlias() ?? '');
         }
     }
@@ -91,7 +91,7 @@ public function currentEntityIcon(): string
     #[Computed]
     public function entityTypes(): Collection
     {
-        return collect(Entities::getOptions(onlyCustomFields: true));
+        return collect(Entities::getOptions(onlyGloballyManaged: true));
     }
 
     public function setCurrentEntityType(?string $entityType): void

src/Filament/Management/Schemas/SectionForm.php

@@ -17,19 +17,48 @@
 use Relaticle\CustomFields\Enums\CustomFieldSectionType;
 use Relaticle\CustomFields\Enums\CustomFieldsFeature;
 use Relaticle\CustomFields\FeatureSystem\FeatureManager;
+use Relaticle\CustomFields\Models\CustomFieldSection;
 use Relaticle\CustomFields\Services\TenantContextService;
 
 class SectionForm implements FormInterface, SectionFormInterface
 {
     private static string $entityType;
 
+    /** @var ?\Closure(Unique, Get): Unique */
+    private static ?\Closure $modifyUniqueRuleUsing = null;
+
     public static function entityType(string $entityType): self
     {
         self::$entityType = $entityType;
+        self::$modifyUniqueRuleUsing = null;
 
         return new self;
     }
 
+    public function modifyUniqueRuleUsing(\Closure $callback): self
+    {
+        self::$modifyUniqueRuleUsing = $callback;
+
+        return $this;
+    }
+
+    private static function buildUniqueRule(Unique $rule, Get $get): Unique
+    {
+        $rule = $rule->when(
+            FeatureManager::isEnabled(CustomFieldsFeature::SYSTEM_MULTI_TENANCY),
+            fn (Unique $rule) => $rule->where(
+                config('custom-fields.database.column_names.tenant_foreign_key'),
+                TenantContextService::getCurrentTenantId()
+            )
+        )->where('entity_type', self::$entityType);
+
+        if (self::$modifyUniqueRuleUsing) {
+            $rule = (self::$modifyUniqueRuleUsing)($rule, $get);
+        }
+
+        return $rule;
+    }
+
     /**
      * @return array<int, Component>
      */
@@ -47,18 +76,8 @@ public static function schema(): array
                     ->unique(
                         table: CustomFields::sectionModel(),
                         column: 'name',
-                        ignoreRecord: true,
-                        modifyRuleUsing: fn (Unique $rule, Get $get) => $rule
-                            ->when(
-                                FeatureManager::isEnabled(CustomFieldsFeature::SYSTEM_MULTI_TENANCY),
-                                fn (Unique $rule) => $rule->where(
-                                    config(
-                                        'custom-fields.database.column_names.tenant_foreign_key'
-                                    ),
-                                    TenantContextService::getCurrentTenantId()
-                                )
-                            )
-                            ->where('entity_type', self::$entityType)
+                        ignorable: fn (TextInput $component) => ($record = $component->getRecord()) instanceof CustomFieldSection ? $record : null,
+                        modifyRuleUsing: fn (Unique $rule, Get $get) => self::buildUniqueRule($rule, $get),
                     )
                     ->afterStateUpdated(function (
                         Get $get,
@@ -89,18 +108,8 @@ public static function schema(): array
                     ->unique(
                         table: CustomFields::sectionModel(),
                         column: 'code',
-                        ignoreRecord: true,
-                        modifyRuleUsing: fn (Unique $rule, Get $get) => $rule
-                            ->when(
-                                FeatureManager::isEnabled(CustomFieldsFeature::SYSTEM_MULTI_TENANCY),
-                                fn (Unique $rule) => $rule->where(
-                                    config(
-                                        'custom-fields.database.column_names.tenant_foreign_key'
-                                    ),
-                                    TenantContextService::getCurrentTenantId()
-                                )
-                            )
-                            ->where('entity_type', self::$entityType)
+                        ignorable: fn (TextInput $component) => ($record = $component->getRecord()) instanceof CustomFieldSection ? $record : null,
+                        modifyRuleUsing: fn (Unique $rule, Get $get) => self::buildUniqueRule($rule, $get),
                     )
                     ->afterStateUpdated(function (
                         Set $set,