bs_ad_calendar 1.0.1

A fully customizable Nepali (Bikram Sambat) and Gregorian calendar widget for Flutter. Dual calendar modes, AD ↔ BS date conversion, interactive monthly calendar, modal date pickers, dual locale (Engl [...]

1.0.1

• Documentation update: Enhanced README with badges and demo section
• NEW: Added link to test app repository for hands-on testing
• NEW: Added demo video documentation
• FIX: Updated package metadata for better pub.dev discoverability

1.0.0

• Initial release of bs_ad_calendar package.

Calendar Widgets

• NEW: GregorianCalendarWidget – Display standard English (Gregorian) calendar with January-December structure.
• NEW: NepaliCalendarWidget – Display Nepali (Bikram Sambat) calendar with Baisakh-Chaitra structure.
• NEW: CalendarMode enum – Choose between Nepali (Bikram Sambat) or Gregorian calendar display.

Date Conversion

• FEATURE: NepaliDateConverter – Convert between AD (Gregorian) and BS (Bikram Sambat) dates.
• Supports date range: BS 1970–2250 (AD 1913–2193).
• Built-in lookup table covering BS 2000–2100.
• 91-year cycle algorithm for extended range (BS 2101–2250).

Dual Date Display

• FEATURE: Both calendar widgets support dual date display:
  • GregorianCalendarWidget can show Nepali dates as sub-labels.
  • NepaliCalendarWidget can show English dates as sub-labels.
• FEATURE: DatePriority – Choose which date system (BS or AD) is the large primary number.
• NEW: Secondary date color customization:
  • secondaryDateColor – Color for sub-dates on normal days (default: Colors.black54).
  • selectedSecondaryDateColor – Color for sub-dates when day is selected (default: Colors.white).
  • todaySecondaryDateColor – Color for sub-dates on today (default: Colors.white).

Date Pickers

• NEW: showNepaliDatePicker() – Modal single date-picker dialog that returns both BS and AD dates.
• NEW: showNepaliDateRangePicker() – Modal date range picker dialog.
• FEATURE: Range selection mode with highlighted start/end caps and in-range bar.

Customization

• NEW: NepaliCalendarThemeData – One-stop theme object for easy styling.
• FEATURE: Granular style overrides via:
  • NepaliCalendarStyle – Day cell decorations, text styles, cell size.
  • NepaliHeaderStyle – Month/year title, chevron icons, background color.
  • NepaliDaysOfWeekStyle – Weekday label styles, row height, background.
  • NepaliCalendarRangeStyle – Range start/end decorations, in-range styling.

Localization

• FEATURE: Tri-locale support:
  • English (Baisakh, Sun, Mon...)
  • Nepali (बैशाख, आइत, सोम...)
  • Both simultaneously (dual-line display)

Event System

• FEATURE: Event markers via eventLoader callback.
• FEATURE: Custom event marker widget via markerBuilder.

Additional Features

• Interactive year/month picker (tap header to open).
• Today indicator with customizable shape (circle/rectangle).
• Selected date highlighting.
• Disabled dates support with custom styling.
• Zero external dependencies — Flutter SDK only.

Demo & Resources

• NEW: Demo video showcasing all features.
• NEW: Test application repository for hands-on testing: calendar_test_app
• NEW: Comprehensive documentation and usage examples.
• NEW: Issue templates and PR guidelines.