What's Changed

• Bump shell-quote from 1.8.3 to 1.8.4 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #242
• fix Romanian translations by @andreiio in #241

Full Changelog: 5.0.5...5.0.6

Month picker manual input stability

This patch release completes the editable month picker work and fixes the input-mask crash found while testing the demo environment.

Fixed

• Month/year picker manual input no longer uses IMask's day-date mask for month-only or year-only formats.
• Typing partial short-year values such as 01/22 in monthPicker()->singleCalendar()->allowInput()->format('m/Y') no longer causes a maximum call stack error.
• Invalid partial month input stays non-destructive: the previous valid state remains selected until the user enters a complete valid value or clears the field.
• The month picker header avoids stale bundled-JS Alpine references while keeping direct year editing and year navigation.

Demo

• Added a Workbench demo field for the exact manual-input configuration:
  monthPicker()->singleCalendar()->allowInput()->format('m/Y')

Verification

• npm test: 116 passed
• npm run build: passed, rebuilt dist assets
• composer test: 148 passed
• php -l workbench/app/Filament/Pages/DemoPage.php: passed

Fix month picker year input rendering.

• Replace the month picker header year select with a compact numeric year input.
• Keep the active year visible and stable in the popup header.
• Clamp out-of-range typed years back to configured min/max constraints.
• Rebuild dist assets.

Verification:

• npm test: 115 passed
• npm run build: passed
• composer test: 148 passed

Summary

Patch release for month picker editing and keyboard handling fixes.

Fixed

• Fixed month picker manual input Enter handling so typed month values are parsed and applied before keyboard confirmation logic.
• Fixed month/year picker Enter behavior so non-day pickers do not call day-selection code.
• Fixed invalid partial manual input overwriting the previous valid month picker state.

Added

• Added a direct year select control in the month picker popup header.
• Added month picker year option constraints based on existing minYear, maxYear, minDate, and maxDate configuration.

Compatibility

• No PHP public API changes.
• Existing day picker Enter behavior remains unchanged.
• showDropdowns() day picker behavior remains unchanged.
• Built dist assets are included.

Verification

• npm test: 4 test files passed, 114 tests passed.
• npm run build: completed successfully and regenerated dist assets.
• composer test: 148 tests passed, 213 assertions.

Pull Request

• #240

What's Changed

• Bump dependabot/fetch-metadata from 2.5.0 to 3.0.0 by @dependabot[bot] in #232
• Fix timed preset matching in DateRangePicker (active range + range labels) by @bendbot

Full Changelog: 5.0.0...5.0.1

🚀 v5.0 — Complete Rewrite: Alpine.js + Day.js

A ground-up rewrite replacing jQuery & Moment.js with a native Alpine.js component powered by Day.js.

This is a major release with breaking changes. The entire frontend has been rebuilt from scratch for better performance, smaller bundle size, and seamless Filament v4/v5 integration.

✨ What's New

Architecture

• Alpine.js Native — No more jQuery dependency. The picker is a first-class Alpine.js component with full Livewire reactivity.
• Day.js — Replaced Moment.js (330KB) with Day.js (7KB) for date manipulation. ~97% smaller.
• Floating UI — Replaced manual positioning with @floating-ui/dom for robust dropdown placement that handles scroll, resize, and viewport edges automatically.
• IMask.js — Integrated input masking for precise manual date entry with auto-padding and block navigation.

New Features

• 🗓️ Month Picker — ->monthPicker() for selecting month ranges
• 📅 Year Picker — ->yearPicker() for selecting year ranges
• ⌨️ Manual Input — ->allowInput() enables typed date entry with format-aware masking
• 🎯 Teleport — ->teleport() (enabled by default) moves the dropdown to <body>, solving z-index issues in modals and slide-overs
• ♿ Keyboard Navigation — Full arrow key, Home/End, PageUp/PageDown, Enter/Escape support
• 🔗 Dual State Fields — ->dualState('start_field', 'end_field') syncs to two separate Livewire properties
• 📝 PHP Format Tokens — ->format('Y-m-d') uses PHP Carbon tokens. The package auto-converts to Day.js tokens for the frontend.
• 🌍 32 Bundled Locales — All locales are statically imported and work without async loading: ar, cs, da, de, el, es, fa, fr, he, hu, id, it, ko, ku, lt, lv, nb, nl, pl, pt, pt-br, ro, ru, sk, sl, tr, uk, uz, vi, zh-cn, zh-tw

Performance & Quality

• ⚡ Synchronous Init — No more async init(). Locales are bundled, eliminating runtime import latency.
• 🧹 Static Format Map — PHP→Day.js format conversion uses a static class constant instead of rebuilding on every call.
• 🎯 Strict Comparisons — All ==/!= replaced with ===/!== across the codebase.
• 🧪 148 Tests — Comprehensive Pest test suite covering fields, filters, formats, Livewire integration, and default presets.

💥 Breaking Changes

Dependencies Removed

API Changes

Format Method

- ->displayFormat('DD/MM/YYYY')  // Day.js tokens (still works, deprecated)
+ ->format('d/m/Y')              // PHP Carbon tokens (recommended)

Deprecated Methods

These methods still work but will be removed in a future version:

Filament Version

• Requires Filament v4.0+ or Filament v5.0+
• Uses Filament\Support\Facades\FilamentTimezone for system timezone

📋 Migration Guide

1. Update Dependencies

composer require malzariey/filament-daterangepicker-filter:^5.0

2. Remove jQuery/Moment Assets

If you were manually including jQuery or Moment.js for this package, remove them — they're no longer needed.

3. Update Format Calls

// Before (v4)
DateRangePicker::make('range')->displayFormat('DD/MM/YYYY');

// After (v5) — use PHP Carbon tokens
DateRangePicker::make('range')->format('d/m/Y');

4. New Features (Optional)

// Month picker
DateRangePicker::make('month_range')->monthPicker();

// Year picker
DateRangePicker::make('year_range')->yearPicker();

// Manual input with masking
DateRangePicker::make('range')->allowInput();

// Dual state (sync to two separate properties)
DateRangePicker::make('range')->dualState('start_date', 'end_date');

📦 Requirements

Runtime JS Dependencies (bundled)

🙏 Contributors

Thanks to all contributors who helped shape this release:

• @ahmed-rashad-alnaggar — FilamentTimezone integration
• @Youssef-Amjad — Laravel 13 support, version constraint fixes
• @andreiio — Romanian translations
• @tiagof — Portuguese translations
• @juliangums — 12/24-hour format fix

Full Changelog: 4.0.9...5.0.0

What's Changed

• refactor: Filament timezone as default timezone by @ahmed-rashad-alnaggar in #227
• support laravel 13 by @Youssef-Amjad in #231

New Contributors

• @ahmed-rashad-alnaggar made their first contribution in #227

Full Changelog: 4.0.8...4.0.9