Add from/until range filter for number, range, date, and datetime 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 chip for select, radio, button_group, toggle, single relation, and text-like fields — see [Table filters](#table-filters) |
+| **Table filter** | Optional list-filter chip for select, radio, button_group, toggle, single relation, text-like, and number/range/date/datetime fields — see [Table filters](#table-filters) |
 
 Repeater rows are collapsed by default and show type, key, and required flag in the label.
 
@@ -533,10 +533,11 @@ One filter chip per filterable field, compiled from the **Show in table filter**
 | `toggle` | `TernaryFilter` (yes / no / any) |
 | `relation` (single) | `SelectFilter` (searchable, preloaded) |
 | `text`, `textarea`, `email`, `url`, `rich_text` | `Filter` (free-text "contains" search) |
+| `number`, `range`, `date`, `datetime` | `Filter` (inclusive "from"/"until" range) |
 
-Choice fields need at least one option; relation fields need `related_entity` set and `multiple` off.
+Choice fields need at least one option; relation fields need `related_entity` set and `multiple` off. Range filters accept either bound alone (open-ended) or both.
 
-**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.
+**Not filterable at all:** media, multiselect/checkbox list, and compound fields (group, repeater, clone, flexible content) — their values are stored as JSON, not a single comparable value, so no dedicated filter chip is compiled for these.
 
 ### Admin setup
 
@@ -1122,6 +1123,7 @@ php artisan db:seed --class="Moox\Builder\Database\Seeders\BuilderSeeder" --forc
 | 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/text-like field | filter chip on list pages narrows matching records |
+| Table filter on number/range/date/datetime field | from/until range filter narrows matching records; either bound alone also works |
 | Conditional logic (show/hide) | field visibility updates live; hidden required fields do not block save |
 | `?lang=` on translatable resource | values stored per `locale` column |
 
@@ -1148,7 +1150,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 filter chips for select, radio, button_group, toggle, single relation, and text-like fields (`TableFilterCompiler`, `CustomFieldTableFilterQuery`)
+- **Table filters** — opt-in filter chips for select, radio, button_group, toggle, single relation, text-like, and number/range/date/datetime 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`)
@@ -1158,7 +1160,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: number, range, date, datetime, media, multiselect/checkbox list, and compound fields have no filter chip yet
+- Table filters: media, multiselect/checkbox list, and compound fields (JSON-backed values) 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

@@ -86,6 +86,11 @@
         'save_failed' => 'Feldgruppe konnte nicht gespeichert werden',
     ],
 
+    'filters' => [
+        'from' => 'Von',
+        'until' => 'Bis',
+    ],
+
     'field' => [
         'label' => 'Feldbezeichnung',
         'label_helper' => 'Sichtbarer Name im Formular.',
@@ -135,7 +140,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-, Beziehungs- und Textfelder hinzu. Standardmäßig aus.',
+        'show_in_filter_helper' => 'Fügt einen Listenfilter hinzu: Auswahl/Wahr-falsch/Beziehung als Auswahlfilter, Text als Freitextsuche, Zahl/Bereich/Datum/Datum-Zeit als Von-bis-Filter. 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

@@ -86,6 +86,11 @@
         'save_failed' => 'Field group could not be saved',
     ],
 
+    'filters' => [
+        'from' => 'From',
+        'until' => 'Until',
+    ],
+
     'field' => [
         'label' => 'Field label',
         'label_helper' => 'Visible name in the form.',
@@ -135,7 +140,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, relation, and text fields. Off by default.',
+        'show_in_filter_helper' => 'Adds a list filter: select/toggle/relation as a picker, text as a "contains" search, number/range/date/datetime as a from–until range. 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,6 +4,8 @@
 
 namespace Moox\Builder\Compiler;
 
+use Filament\Forms\Components\DatePicker;
+use Filament\Forms\Components\DateTimePicker;
 use Filament\Forms\Components\TextInput;
 use Filament\Tables\Filters\BaseFilter;
 use Filament\Tables\Filters\Filter;
@@ -87,6 +89,7 @@ protected function compileFilter(
             'select', 'radio', 'button_group' => $this->compileChoiceFilter($field, $entity, $modelClass),
             'relation' => $this->compileRelationFilter($field, $entity, $modelClass),
             'text', 'textarea', 'email', 'url', 'rich_text' => $this->compileTextFilter($field),
+            'number', 'range', 'date', 'datetime' => $this->compileRangeFilter($field),
             default => null,
         };
     }
@@ -108,6 +111,44 @@ protected function compileTextFilter(FieldDefinition $field): Filter
                 : null);
     }
 
+    /**
+     * An inclusive "from"/"until" range filter chip for number, range,
+     * date, and datetime fields, since an exact-match chip rarely makes
+     * sense for these types.
+     */
+    protected function compileRangeFilter(FieldDefinition $field): Filter
+    {
+        [$fromInput, $untilInput] = match ($field->type) {
+            'date' => [DatePicker::make('from')->native(false), DatePicker::make('until')->native(false)],
+            'datetime' => [DateTimePicker::make('from')->native(false), DateTimePicker::make('until')->native(false)],
+            default => [TextInput::make('from')->numeric(), TextInput::make('until')->numeric()],
+        };
+
+        return Filter::make($field->name)
+            ->label($field->label)
+            ->schema([
+                $fromInput->label(__('builder::builder.filters.from')),
+                $untilInput->label(__('builder::builder.filters.until')),
+            ])
+            ->query(fn (Builder $query, array $data): Builder => $this->filterQuery->applyRange(
+                $query,
+                $field,
+                $data['from'] ?? null,
+                $data['until'] ?? null,
+            ))
+            ->indicateUsing(function (array $data) use ($field): ?string {
+                $from = $data['from'] ?? null;
+                $until = $data['until'] ?? null;
+
+                return match (true) {
+                    filled($from) && filled($until) => "{$field->label}: {$from} – {$until}",
+                    filled($from) => "{$field->label}: ≥ {$from}",
+                    filled($until) => "{$field->label}: ≤ {$until}",
+                    default => null,
+                };
+            });
+    }
+
     /**
      * @param  class-string<Model&InteractsWithCustomFields>  $modelClass
      */

packages/builder/src/Support/CustomFieldTableFilterQuery.php

@@ -49,6 +49,24 @@ public function applyContains(Builder $query, FieldDefinition $field, mixed $val
         return $query->where($field->name, 'like', '%'.$value.'%');
     }
 
+    /**
+     * Inclusive "from"/"until" bounds, for the range filter chip on
+     * number, range, date, and datetime custom fields. Both bounds are
+     * optional and combine with AND when both are given.
+     */
+    public function applyRange(Builder $query, FieldDefinition $field, mixed $from, mixed $until): Builder
+    {
+        if (filled($from)) {
+            $query->where($field->name, '>=', $from);
+        }
+
+        if (filled($until)) {
+            $query->where($field->name, '<=', $until);
+        }
+
+        return $query;
+    }
+
     /**
      * @param  class-string<Model&InteractsWithCustomFields>  $modelClass
      */

packages/builder/src/Support/FilterableFieldTypes.php

@@ -16,6 +16,7 @@ public static function supports(FieldDefinition $field): bool
             'relation' => ! RelationValueRules::isMultiple($field)
                 && filled($field->config['related_entity'] ?? null),
             'text', 'textarea', 'email', 'url', 'rich_text' => true,
+            'number', 'range', 'date', 'datetime' => true,
             default => false,
         };
     }
@@ -30,6 +31,7 @@ public static function supportsType(string $type): bool
         return match ($type) {
             'select', 'radio', 'button_group', 'toggle', 'relation' => true,
             'text', 'textarea', 'email', 'url', 'rich_text' => true,
+            'number', 'range', 'date', 'datetime' => true,
             default => false,
         };
     }

packages/builder/tests/Unit/FieldGroupResourceFilterVisibilityTest.php

@@ -22,14 +22,14 @@ function fieldTypeSupportsFilter(?string $type): bool
 })->with([
     'select', 'radio', 'button_group', 'toggle', 'relation',
     'text', 'textarea', 'email', 'url', 'rich_text',
+    'number', 'range', 'date', 'datetime',
 ]);
 
 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 {

packages/builder/tests/Unit/FilterableFieldTypesTest.php

@@ -82,6 +82,16 @@
     expect(FilterableFieldTypes::supports($field))->toBeTrue();
 })->with(['text', 'textarea', 'email', 'url', 'rich_text']);
 
+it('supports number, range, date, and datetime fields via the range filter', function (string $type): void {
+    $field = FieldDefinition::fromArray([
+        'name' => 'mileage',
+        'label' => 'Mileage',
+        'type' => $type,
+    ]);
+
+    expect(FilterableFieldTypes::supports($field))->toBeTrue();
+})->with(['number', 'range', 'date', 'datetime']);
+
 it('does not support non-filterable field types', function (): void {
     $field = FieldDefinition::fromArray([
         'name' => 'notes',

packages/builder/tests/Unit/TableFilterCompilerTest.php

@@ -290,6 +290,90 @@
     expect(TestItemResource::customFieldFilters())->toBe([]);
 });
 
+it('filters list queries by number custom fields via the range filter chip', function (): void {
+    $group = FieldGroup::query()->create([
+        'name' => 'Mileage filter',
+        'slug' => 'mileage-filter',
+        'location_rules' => [[['param' => 'entity', 'operator' => '==', 'value' => 'item']]],
+        'active' => true,
+    ]);
+
+    Field::query()->create([
+        'field_group_id' => $group->getKey(),
+        'name' => 'mileage',
+        'label' => 'Mileage',
+        'type' => 'number',
+        'settings' => ['show_in_filter' => true],
+        'sort' => 0,
+        'validation' => ['required' => false, 'rules' => []],
+    ]);
+
+    Cache::forget(DefinitionRegistry::CACHE_KEY);
+    TestItem::flushCustomFieldDefinitionCache();
+
+    $filters = TestItemResource::customFieldFilters();
+    $rangeFilter = collect($filters)->first(fn ($filter) => $filter instanceof Filter);
+
+    expect($rangeFilter)->not->toBeNull()
+        ->and($rangeFilter->getName())->toBe('mileage');
+
+    $lowMileage = TestItem::query()->create(['title' => 'Low mileage car']);
+    $highMileage = TestItem::query()->create(['title' => 'High mileage car']);
+
+    app(CustomFieldsManager::class)->saveFromFormData(TestItemResource::class, $lowMileage, [
+        'mileage' => 10000,
+    ]);
+    app(CustomFieldsManager::class)->saveFromFormData(TestItemResource::class, $highMileage, [
+        'mileage' => 90000,
+    ]);
+
+    $filtered = $rangeFilter->apply(TestItem::query(), ['from' => 5000, 'until' => 50000])->pluck('id')->all();
+
+    expect($filtered)->toBe([$lowMileage->getKey()]);
+});
+
+it('filters list queries by date custom fields via the range filter chip using only one bound', function (): void {
+    $group = FieldGroup::query()->create([
+        'name' => 'Registered filter',
+        'slug' => 'registered-filter',
+        'location_rules' => [[['param' => 'entity', 'operator' => '==', 'value' => 'item']]],
+        'active' => true,
+    ]);
+
+    Field::query()->create([
+        'field_group_id' => $group->getKey(),
+        'name' => 'registered_at',
+        'label' => 'Registered at',
+        'type' => 'date',
+        'settings' => ['show_in_filter' => true],
+        'sort' => 0,
+        'validation' => ['required' => false, 'rules' => []],
+    ]);
+
+    Cache::forget(DefinitionRegistry::CACHE_KEY);
+    TestItem::flushCustomFieldDefinitionCache();
+
+    $filters = TestItemResource::customFieldFilters();
+    $rangeFilter = collect($filters)->first(fn ($filter) => $filter instanceof Filter);
+
+    expect($rangeFilter)->not->toBeNull()
+        ->and($rangeFilter->getName())->toBe('registered_at');
+
+    $older = TestItem::query()->create(['title' => 'Older car']);
+    $newer = TestItem::query()->create(['title' => 'Newer car']);
+
+    app(CustomFieldsManager::class)->saveFromFormData(TestItemResource::class, $older, [
+        'registered_at' => '2020-01-01',
+    ]);
+    app(CustomFieldsManager::class)->saveFromFormData(TestItemResource::class, $newer, [
+        'registered_at' => '2024-01-01',
+    ]);
+
+    $filtered = $rangeFilter->apply(TestItem::query(), ['from' => '2023-01-01'])->pluck('id')->all();
+
+    expect($filtered)->toBe([$newer->getKey()]);
+});
+
 it('does not build filters for multiple relation fields', function (): void {
     $group = FieldGroup::query()->create([
         'name' => 'Multiple relation filter',