Add free-text filter chip for text-like custom fields

Author: AzGasim

packages/builder/README.md

@@ -462,7 +462,7 @@ Navigation: **Fields → Field Groups**
 | **Visibility** | Per context: admin, frontend, API (`visible_*` toggles) |
 | **Conditional logic** | Show/hide rules based on sibling field values (root, group, repeater, flexible layout) |
 | **Table column** | Optional list-column settings for scalar, media, and relation fields — see [Table columns](#table-columns) |
-| **Table filter** | Optional list-filter for select, radio, button_group, toggle, and single relation fields — see [Table filters](#table-filters) |
+| **Table filter** | Optional list-filter chip for select, radio, button_group, toggle, single relation, and text-like fields — see [Table filters](#table-filters) |
 
 Repeater rows are collapsed by default and show type, key, and required flag in the label.
 
@@ -523,17 +523,20 @@ public static function table(Table $table): Table
 
 ## Table filters
 
-Opt-in Filament list filters for custom fields. Filtering runs as subqueries on `builder_field_values` — the consumer model needs no filter scopes.
+Opt-in Filament list filter chips for custom fields. Filtering runs as subqueries on `builder_field_values` — the consumer model needs no filter scopes.
 
-### Supported field types
+One filter chip per filterable field, compiled from the **Show in table filter** toggle:
+
+| Field type | Filter chip |
+|------------|-------------|
+| `select`, `radio`, `button_group` | `SelectFilter` (options from field definition) |
+| `toggle` | `TernaryFilter` (yes / no / any) |
+| `relation` (single) | `SelectFilter` (searchable, preloaded) |
+| `text`, `textarea`, `email`, `url`, `rich_text` | `Filter` (free-text "contains" search) |
 
-| Field type | Filter UI | Requirements |
-|------------|-----------|--------------|
-| `select`, `radio`, `button_group` | `SelectFilter` (options from field definition) | At least one option |
-| `toggle` | `TernaryFilter` (yes / no / any) | — |
-| `relation` | `SelectFilter` (searchable, preloaded) | `related_entity` set, `multiple` off |
+Choice fields need at least one option; relation fields need `related_entity` set and `multiple` off.
 
-**Not filterable:** all other types (text, number, media, compound fields, multiselect, etc.).
+**Not filterable at all:** number, range, date, datetime, media, multiselect/checkbox list, and compound fields (group, repeater, clone, flexible content) — no dedicated filter chip is compiled for these.
 
 ### Admin setup
 
@@ -585,11 +588,11 @@ Other resources with `HasCustomFields` do **not** get filters automatically —
 FieldGroup (show_in_filter = true)
     → DefinitionRegistry
     → TableFilterCompiler
-    → SelectFilter / TernaryFilter
+    → SelectFilter / TernaryFilter / Filter (text)
     → CustomFieldTableFilterQuery (subquery on builder_field_values)
 ```
 
-Only fields marked `settings.show_in_filter` in active, location-matched groups are compiled. Filter names use the field key (`fuel`, `accident_free`, …).
+Only fields marked `settings.show_in_filter` in active, location-matched groups are compiled. Filter (chip) names use the field key (`fuel`, `accident_free`, …).
 
 ### Troubleshooting
 
@@ -1118,7 +1121,7 @@ php artisan db:seed --class="Moox\Builder\Database\Seeders\BuilderSeeder" --forc
 | Image/gallery/file (with `moox/media`) | library filtered, save/load works, `media_usables` updated |
 | Relation field on a group | searchable select, save/load IDs, API shows labels |
 | Table column on scalar/toggle/media/relation field | column appears (toggle via column picker if hidden by default) |
-| Table filter on select/radio/button_group/toggle/relation | filter chip on list pages narrows matching records |
+| Table filter on select/radio/button_group/toggle/relation/text-like field | filter chip on list pages narrows matching records |
 | Conditional logic (show/hide) | field visibility updates live; hidden required fields do not block save |
 | `?lang=` on translatable resource | values stored per `locale` column |
 
@@ -1145,7 +1148,7 @@ php artisan db:seed --class="Moox\Builder\Database\Seeders\BuilderSeeder" --forc
 - **Per-context visibility** — `visible_admin`, `visible_api`, `visible_frontend` (admin + API wired)
 - **Location rules** — entity, record type, record status, user role, taxonomy term IDs (admin constraints + import/export)
 - **Table columns** — opt-in list columns for scalar, media, and relation fields (`TableColumnCompiler`)
-- **Table filters** — opt-in list filters for select, radio, button_group, toggle, and single relation fields (`TableFilterCompiler`, `CustomFieldTableFilterQuery`)
+- **Table filters** — opt-in filter chips for select, radio, button_group, toggle, single relation, and text-like fields (`TableFilterCompiler`, `CustomFieldTableFilterQuery`)
 - **Field width grid** — 12-column layout per field (`FieldWidth`)
 - **Sidebar placement** — `main` vs `sidebar` field group slots
 - **Translations** — definition + value locales (Astrotomic + `builder_field_values.locale`)
@@ -1155,7 +1158,7 @@ php artisan db:seed --class="Moox\Builder\Database\Seeders\BuilderSeeder" --forc
 **v1 limitations (known):**
 
 - Location rules: no template/parent params yet; record/taxonomy/status rules need a saved record (ignored on create)
-- Table filters: no centralized filter builder / preset groups yet (per-field opt-in only)
+- Table filters: number, range, date, datetime, media, multiselect/checkbox list, and compound fields have no filter chip yet
 - Custom `validation.rules`: supported in schema/DB, no admin UI (programmatic only)
 - Relation targets: Filament-registered Moox resources only (not arbitrary Eloquent models)
 

packages/builder/resources/lang/de/builder.php

@@ -135,7 +135,7 @@
         'show_in_table' => 'In Tabelle anzeigen',
         'show_in_table_helper' => 'Fügt dieses Feld als Spalte auf den Listen-Seiten hinzu. Standardmäßig ausgeblendet; über den Spalten-Umschalter aktivierbar.',
         'show_in_filter' => 'Als Listenfilter',
-        'show_in_filter_helper' => 'Fügt einen Listenfilter für Auswahl-, Wahr/falsch- und Beziehungsfelder hinzu. Standardmäßig aus.',
+        'show_in_filter_helper' => 'Fügt einen Listenfilter für Auswahl-, Wahr/falsch-, Beziehungs- und Textfelder hinzu. Standardmäßig aus.',
         'show_in_filter_relation_multiple_helper' => 'Listenfilter gibt es nur für einfache Beziehungsfelder (ohne Mehrfachauswahl).',
         'show_in_filter_relation_entity_helper' => 'Zuerst „Beziehung zu“ wählen, dann den Listenfilter aktivieren.',
         'show_in_filter_choice_options_helper' => 'Mindestens eine Option hinzufügen, bevor der Listenfilter aktiviert werden kann.',

packages/builder/resources/lang/en/builder.php

@@ -135,7 +135,7 @@
         'show_in_table' => 'Show in table',
         'show_in_table_helper' => 'Adds this field as a column on entity list pages. Hidden by default; enable via the column toggle.',
         'show_in_filter' => 'Show in table filter',
-        'show_in_filter_helper' => 'Adds a list filter for select, toggle, and single relation fields. Off by default.',
+        'show_in_filter_helper' => 'Adds a list filter for select, toggle, relation, and text fields. Off by default.',
         'show_in_filter_relation_multiple_helper' => 'List filters are only available for single relation fields. Disable “Multiple” first.',
         'show_in_filter_relation_entity_helper' => 'Choose a related entity before enabling the list filter.',
         'show_in_filter_choice_options_helper' => 'Add at least one option before enabling the list filter.',

packages/builder/src/Compiler/TableFilterCompiler.php

@@ -4,7 +4,9 @@
 
 namespace Moox\Builder\Compiler;
 
+use Filament\Forms\Components\TextInput;
 use Filament\Tables\Filters\BaseFilter;
+use Filament\Tables\Filters\Filter;
 use Filament\Tables\Filters\SelectFilter;
 use Filament\Tables\Filters\TernaryFilter;
 use Illuminate\Database\Eloquent\Builder;
@@ -54,15 +56,14 @@ public function compile(Collection $fieldGroups, ?string $resourceClass = null):
             return [];
         }
 
-        $fields = $this->storableFieldCollector
+        $filterableFields = $this->storableFieldCollector
             ->definitionsFromList($fieldGroups->flatMap(fn (FieldGroupDefinition $group): Collection => $group->fields))
-            ->filter(fn (FieldDefinition $field): bool => $field->showInFilter()
-                && FilterableFieldTypes::supports($field))
+            ->filter(fn (FieldDefinition $field): bool => $field->showInFilter())
             ->values();
 
         $filters = [];
 
-        foreach ($fields as $field) {
+        foreach ($filterableFields->filter(fn (FieldDefinition $field): bool => FilterableFieldTypes::supports($field)) as $field) {
             $filter = $this->compileFilter($field, $entity, $modelClass);
 
             if ($filter !== null) {
@@ -85,10 +86,28 @@ protected function compileFilter(
             'toggle' => $this->compileToggleFilter($field, $entity, $modelClass),
             'select', 'radio', 'button_group' => $this->compileChoiceFilter($field, $entity, $modelClass),
             'relation' => $this->compileRelationFilter($field, $entity, $modelClass),
+            'text', 'textarea', 'email', 'url', 'rich_text' => $this->compileTextFilter($field),
             default => null,
         };
     }
 
+    /**
+     * A simple "contains" search filter chip for text-like fields.
+     */
+    protected function compileTextFilter(FieldDefinition $field): Filter
+    {
+        return Filter::make($field->name)
+            ->label($field->label)
+            ->schema([
+                TextInput::make('value')
+                    ->label($field->label),
+            ])
+            ->query(fn (Builder $query, array $data): Builder => $this->filterQuery->applyContains($query, $field, $data['value'] ?? null))
+            ->indicateUsing(fn (array $data): ?string => filled($data['value'] ?? null)
+                ? "{$field->label}: {$data['value']}"
+                : null);
+    }
+
     /**
      * @param  class-string<Model&InteractsWithCustomFields>  $modelClass
      */

packages/builder/src/Resources/FieldGroupResource.php

@@ -40,6 +40,7 @@
 use Moox\Builder\Support\FieldGroupPlacement;
 use Moox\Builder\Support\FieldValidationRules;
 use Moox\Builder\Support\FieldWidth;
+use Moox\Builder\Support\FilterableFieldTypes;
 use Moox\Builder\Support\LocationConstraintOptions;
 use Moox\Builder\Support\TypedValueColumns;
 
@@ -672,7 +673,7 @@ protected static function fieldTypeSupportsFilter(?string $type): bool
             return false;
         }
 
-        return in_array($type, ['select', 'radio', 'button_group', 'toggle', 'relation'], true);
+        return FilterableFieldTypes::supportsType($type);
     }
 
     protected static function fieldHasFilterableChoiceOptions(callable $get): bool

packages/builder/src/Support/CustomFieldTableFilterQuery.php

@@ -36,6 +36,19 @@ public function applyEquals(
         return $query->where($field->name, $this->normalizeValue($field, $value));
     }
 
+    /**
+     * Case-insensitive "contains" search, for the free-text filter chip on
+     * text-like custom fields.
+     */
+    public function applyContains(Builder $query, FieldDefinition $field, mixed $value): Builder
+    {
+        if (! filled($value)) {
+            return $query;
+        }
+
+        return $query->where($field->name, 'like', '%'.$value.'%');
+    }
+
     /**
      * @param  class-string<Model&InteractsWithCustomFields>  $modelClass
      */

packages/builder/src/Support/FilterableFieldTypes.php

@@ -15,6 +15,21 @@ public static function supports(FieldDefinition $field): bool
             'toggle' => true,
             'relation' => ! RelationValueRules::isMultiple($field)
                 && filled($field->config['related_entity'] ?? null),
+            'text', 'textarea', 'email', 'url', 'rich_text' => true,
+            default => false,
+        };
+    }
+
+    /**
+     * Type-only check (no field instance required), e.g. to decide whether
+     * the admin "Show in table filter" toggle should be offered at all,
+     * before options or relation config are known.
+     */
+    public static function supportsType(string $type): bool
+    {
+        return match ($type) {
+            'select', 'radio', 'button_group', 'toggle', 'relation' => true,
+            'text', 'textarea', 'email', 'url', 'rich_text' => true,
             default => false,
         };
     }

packages/builder/tests/Feature/HasCustomFieldsTest.php

@@ -9,6 +9,7 @@
 use Filament\Resources\Events\RecordSaved;
 use Filament\Resources\Pages\Page;
 use Filament\Schemas\Components\Section;
+use Filament\Tables\Filters\SelectFilter;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\Event;
 use Moox\Builder\Models\Field;
@@ -75,7 +76,10 @@
     Cache::forget(DefinitionRegistry::CACHE_KEY);
     TestItem::flushCustomFieldDefinitionCache();
 
-    expect(TestItemResource::customFieldFilters())->toHaveCount(1);
+    $filters = TestItemResource::customFieldFilters();
+
+    expect($filters)->toHaveCount(1)
+        ->and($filters[0])->toBeInstanceOf(SelectFilter::class);
 });
 
 it('returns no components when no field groups match the entity', function (): void {

packages/builder/tests/Unit/FieldGroupResourceFilterVisibilityTest.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+require_once __DIR__.'/../TestCase.php';
+
+use Moox\Builder\Resources\FieldGroupResource;
+use Moox\Builder\Tests\TestCase;
+
+uses(TestCase::class);
+
+function fieldTypeSupportsFilter(?string $type): bool
+{
+    $method = new ReflectionMethod(FieldGroupResource::class, 'fieldTypeSupportsFilter');
+    $method->setAccessible(true);
+
+    return $method->invoke(null, $type);
+}
+
+it('offers the "show in table filter" toggle for every compiler-supported field type', function (string $type): void {
+    expect(fieldTypeSupportsFilter($type))->toBeTrue();
+})->with([
+    'select', 'radio', 'button_group', 'toggle', 'relation',
+    'text', 'textarea', 'email', 'url', 'rich_text',
+]);
+
+it('does not offer the toggle for field types with no filter support', function (string $type): void {
+    expect(fieldTypeSupportsFilter($type))->toBeFalse();
+})->with([
+    'multiselect', 'checkbox_list', 'image', 'gallery', 'file',
+    'group', 'clone', 'repeater', 'flexible_content', 'password',
+    'number', 'range', 'date', 'datetime',
+]);
+
+it('does not offer the toggle when no type is selected yet', function (): void {
+    expect(fieldTypeSupportsFilter(null))->toBeFalse();
+});

packages/builder/tests/Unit/FilterableFieldTypesTest.php

@@ -72,11 +72,21 @@
     expect(FilterableFieldTypes::supports($field))->toBeFalse();
 });
 
+it('supports text-like fields', function (string $type): void {
+    $field = FieldDefinition::fromArray([
+        'name' => 'notes',
+        'label' => 'Notes',
+        'type' => $type,
+    ]);
+
+    expect(FilterableFieldTypes::supports($field))->toBeTrue();
+})->with(['text', 'textarea', 'email', 'url', 'rich_text']);
+
 it('does not support non-filterable field types', function (): void {
     $field = FieldDefinition::fromArray([
         'name' => 'notes',
         'label' => 'Notes',
-        'type' => 'text',
+        'type' => 'repeater',
     ]);
 
     expect(FilterableFieldTypes::supports($field))->toBeFalse();