Feature/auto detect model context

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

@@ -6,10 +6,11 @@
 
 use Filament\Infolists\Components\Entry;
 use Filament\Schemas\Components\Component;
-use Filament\Schemas\Components\Grid;
+use Illuminate\Database\Eloquent\Model;
 use Illuminate\Support\Collection;
 use Relaticle\CustomFields\Filament\Integration\Factories\FieldInfolistsFactory;
 use Relaticle\CustomFields\Filament\Integration\Factories\SectionInfolistsFactory;
+use Relaticle\CustomFields\Models\Contracts\HasCustomFields;
 use Relaticle\CustomFields\Models\CustomField;
 use Relaticle\CustomFields\Models\CustomFieldSection;
 use Relaticle\CustomFields\Services\Visibility\BackendVisibilityService;
@@ -24,14 +25,24 @@ final class InfolistBuilder extends BaseBuilder
 
     public function build(): Component
     {
-        return Grid::make(1)->schema($this->values()->toArray());
+        return InfolistContainer::make()
+            ->forModel($this->explicitModel ?? null)
+            ->hiddenLabels($this->hiddenLabels)
+            ->visibleWhenFilled($this->visibleWhenFilled)
+            ->withoutSections($this->withoutSections)
+            ->only($this->only)
+            ->except($this->except);
     }
 
     /**
      * @return Collection<int, mixed>
      */
-    public function values(): Collection
+    public function values(null|(Model&HasCustomFields) $model = null): Collection
     {
+        if ($model !== null) {
+            $this->forModel($model);
+        }
+
         $fieldInfolistsFactory = app(FieldInfolistsFactory::class);
         $sectionInfolistsFactory = app(SectionInfolistsFactory::class);
         $backendVisibilityService = app(BackendVisibilityService::class);

src/Filament/Integration/Builders/InfolistContainer.php

@@ -0,0 +1,97 @@
+<?php
+
+namespace Relaticle\CustomFields\Filament\Integration\Builders;
+
+use Filament\Forms\Components\Field;
+use Filament\Schemas\Components\Grid;
+use Illuminate\Database\Eloquent\Model;
+
+final class InfolistContainer extends Grid
+{
+    private Model|string|null $explicitModel = null;
+
+    private array $except = [];
+
+    private array $only = [];
+
+    private bool $hiddenLabels = false;
+
+    private bool $visibleWhenFilled = false;
+
+    private bool $withoutSections = false;
+
+    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;
+    }
+
+    public function hiddenLabels(bool $hiddenLabels = true): static
+    {
+        $this->hiddenLabels = $hiddenLabels;
+
+        return $this;
+    }
+
+    public function visibleWhenFilled(bool $visibleWhenFilled = true): static
+    {
+        $this->visibleWhenFilled = $visibleWhenFilled;
+
+        return $this;
+    }
+
+    public function withoutSections(bool $withoutSections = true): static
+    {
+        $this->withoutSections = $withoutSections;
+
+        return $this;
+    }
+
+    /**
+     * @return array<int, Field>
+     */
+    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(InfolistBuilder::class)
+            ->forModel($model)
+            ->only($this->only)
+            ->except($this->except)
+            ->hiddenLabels($this->hiddenLabels)
+            ->visibleWhenFilled($this->visibleWhenFilled)
+            ->withoutSections($this->withoutSections);
+
+        return $builder->values()->toArray();
+    }
+}