SugarCalendar
Interactive date picker
Month-grid date picker with keyboard navigation, min/max date constraints, locale-aware day names, and a fully-rendered ANSI view.
Install
composer require sugarcraft/sugar-calendarQuickstart
use SugarCraft\Calendar\DatePicker;
$picker = DatePicker::new(new \DateTimeImmutable('2026-01-01'));
$picker = $picker->withMinDate(new \DateTimeImmutable('2025-01-01'));
$picker = $picker->withMaxDate(new \DateTimeImmutable('2027-12-31'));
echo $picker->view(); // renders month gridWhat's in the box
Month gridFull month view with day letters, today highlight, cursor.
Keyboard navArrow keys, Enter to select, Esc to cancel.
Min / Max constraintsRestrict selectable date range.
Locale supportCustom day/month names via configuration.
Source & demos
- Source on GitHub
- Full README
- Runnable examples
- Port of EthanEFung/bubble-datepicker (Go upstream)
API
| Class | Method | Description |
|---|---|---|
| DatePicker | new(date) | Create date picker |
| DatePicker | withMinDate(date) | Set minimum selectable date |
| DatePicker | withMaxDate(date) | Set maximum selectable date |
| DatePicker | view() | Render calendar view |
| DatePicker | selected() | Get selected date |
