feat: add automatic model context detection for form and infolist builders

Add smart auto-detection that allows CustomFields form and infolist builders
to work without explicit forModel()/forSchema() calls by detecting context
from Filament component hierarchy.

Changes:
- Add FormContainer component with deferred schema generation
- Update InfolistContainer to use inline priority resolution
- Add explicitModel tracking in BaseBuilder
- Implement priority system: explicit > auto-detect > fallback
- Use inline priority pattern (KISS): explicitModel ?? getRecord() ?? getModel()

All builders now support three usage patterns:
1. Auto-detection: CustomFields::form()->build()
2. Explicit model: CustomFields::form()->forModel(Post::class)->build()
3. Explicit schema: CustomFields::form()->forSchema($schema)->build()

Priority resolution ensures explicit parameters always take precedence over
auto-detection. Graceful fallback returns empty array when no context available.

Zero breaking changes - all existing usage patterns continue to work.

Author: ManukMinasyan

src/Filament/Integration/Builders/BaseBuilder.php

@@ -19,6 +19,8 @@ abstract class BaseBuilder
 {
     protected Model&HasCustomFields $model;
 
+    protected Model|string|null $explicitModel = null;
+
     protected Builder $sections;
 
     protected array $except = [];
@@ -52,6 +54,7 @@ public function forModel(Model|string $model): static
         }
 
         $this->model = $model;
+        $this->explicitModel = $model;
 
         $this->sections = CustomFields::newSectionModel()->query()
             ->forEntityType($model::class)

src/Filament/Integration/Builders/FormBuilder.php

@@ -16,7 +16,10 @@ class FormBuilder extends BaseBuilder
 {
     public function build(): Grid
     {
-        return Grid::make(1)->schema($this->values()->toArray());
+        return FormContainer::make()
+            ->forModel($this->explicitModel ?? null)
+            ->only($this->only)
+            ->except($this->except);
     }
 
     private function getDependentFieldCodes(Collection $fields): array

src/Filament/Integration/Builders/FormContainer.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Relaticle\CustomFields\Filament\Integration\Builders;
+
+use Filament\Schemas\Components\Grid;
+use Illuminate\Database\Eloquent\Model;
+
+final class FormContainer extends Grid
+{
+    private Model|string|null $explicitModel = null;
+
+    private array $except = [];
+
+    private array $only = [];
+
+    public static function make(array|int|null $columns = 1): static
+    {
+        $container = new self($columns);
+
+        // Defer schema generation until component is in container
+        $container->schema(fn (): array => $container->generateSchema());
+
+        return $container;
+    }
+
+    public function forModel(Model|string|null $model): static
+    {
+        $this->explicitModel = $model;
+
+        return $this;
+    }
+
+    public function except(array $fieldCodes): static
+    {
+        $this->except = $fieldCodes;
+
+        return $this;
+    }
+
+    public function only(array $fieldCodes): static
+    {
+        $this->only = $fieldCodes;
+
+        return $this;
+    }
+
+    private function generateSchema(): array
+    {
+        // Inline priority: explicit ?? record ?? model class
+        $model = $this->explicitModel ?? $this->getRecord() ?? $this->getModel();
+
+        if ($model === null) {
+            return []; // Graceful fallback
+        }
+
+        $builder = app(FormBuilder::class);
+
+        return $builder
+            ->forModel($model)
+            ->only($this->only)
+            ->except($this->except)
+            ->values()
+            ->toArray();
+    }
+}

src/Filament/Integration/Builders/InfolistBuilder.php

@@ -14,7 +14,6 @@
 use Relaticle\CustomFields\Models\CustomField;
 use Relaticle\CustomFields\Models\CustomFieldSection;
 use Relaticle\CustomFields\Services\Visibility\BackendVisibilityService;
-use Throwable;
 
 final class InfolistBuilder extends BaseBuilder
 {
@@ -26,14 +25,8 @@ final class InfolistBuilder extends BaseBuilder
 
     public function build(): Component
     {
-        try {
-            $model = $this->model;
-        } catch (Throwable) {
-            $model = null;
-        }
-
         return InfolistContainer::make()
-            ->forModel($model)
+            ->forModel($this->explicitModel ?? null)
             ->hiddenLabels($this->hiddenLabels)
             ->visibleWhenFilled($this->visibleWhenFilled)
             ->withoutSections($this->withoutSections)
@@ -44,7 +37,7 @@ public function build(): Component
     /**
      * @return Collection<int, mixed>
      */
-    public function values(null | (Model & HasCustomFields) $model = null): Collection
+    public function values(null|(Model&HasCustomFields) $model = null): Collection
     {
         if ($model !== null) {
             $this->forModel($model);

src/Filament/Integration/Builders/InfolistContainer.php

@@ -3,39 +3,36 @@
 namespace Relaticle\CustomFields\Filament\Integration\Builders;
 
 use Filament\Forms\Components\Field;
-use Filament\Schemas\Components\Component;
+use Filament\Schemas\Components\Grid;
 use Illuminate\Database\Eloquent\Model;
 
-final class InfolistContainer extends Component
+final class InfolistContainer extends Grid
 {
-    protected string $view = 'filament-schemas::components.grid';
+    private Model|string|null $explicitModel = null;
 
-    protected Model|string|null $recordModel;
+    private array $except = [];
 
-    protected array $except = [];
-
-    protected array $only = [];
+    private array $only = [];
 
     private bool $hiddenLabels = false;
 
     private bool $visibleWhenFilled = false;
 
     private bool $withoutSections = false;
 
-    public function __construct()
+    public static function make(array|int|null $columns = 1): static
     {
-        // Defer schema generation until we can safely access the record
-        $this->schema(fn() => $this->generateSchema());
-    }
+        $container = new self($columns);
 
-    public static function make(): static
-    {
-        return app(self::class);
+        // Defer schema generation until component is in container
+        $container->schema(fn (): array => $container->generateSchema());
+
+        return $container;
     }
 
     public function forModel(Model|string|null $model): static
     {
-        $this->recordModel = $model;
+        $this->explicitModel = $model;
 
         return $this;
     }
@@ -78,19 +75,23 @@ public function withoutSections(bool $withoutSections = true): static
     /**
      * @return array<int, Field>
      */
-    protected function generateSchema(): array
+    private function generateSchema(): array
     {
-        $model = $this->recordModel ?? $this->getRecord() ?? $this->getModel();
+        // Inline priority: explicit ?? record ?? model class
+        $model = $this->explicitModel ?? $this->getRecord() ?? $this->getModel();
 
-        $builder = app(InfolistBuilder::class);
+        if ($model === null) {
+            return []; // Graceful fallback
+        }
 
-        return $builder
+        $builder = app(InfolistBuilder::class)
+            ->forModel($model)
             ->only($this->only)
             ->except($this->except)
             ->hiddenLabels($this->hiddenLabels)
             ->visibleWhenFilled($this->visibleWhenFilled)
-            ->withoutSections($this->withoutSections)
-            ->values($model)
-            ->toArray();
+            ->withoutSections($this->withoutSections);
+
+        return $builder->values()->toArray();
     }
 }