🔄 In progress

  1. 📦 Authoritative BS tables In progress

    Ship a complete, authoritative Bikram Sambat year table (2000–2100 BS) as a separate data package so users don't need to source their own conversion data.

    • Compile and verify BS↔AD mappings from official Nepali calendar sources.
    • Publish as a companion npm package with versioned releases.
    • Include a pre-built adapter factory that consumes the data package.
    • Add CI verification to catch date mismatch regressions.

⏳ Planned

  1. 📅 Range picker + dual calendar view Planned

    A new NepaliDateRangePicker component for selecting a start and end date, with a side-by-side dual-month view.

    • Select start and end dates with visual range highlighting.
    • Dual-month layout showing two consecutive BS months side by side.
    • Reuse disable rules, localization, and styling from the single picker.
    • Controlled and uncontrolled modes with range value.
  2. 📖 Storybook stories & visual regression Planned

    Build a comprehensive Storybook catalog for visual testing, documentation, and easier contributor onboarding.

    • Stories for every prop combination, locale, and disable rule.
    • Visual regression testing with Chromatic to catch unintended style changes.
    • Interactive playground stories for live prop exploration.

🔭 Under research

  1. ⌨️ Input masking & ARIA refinements Research

    Polish the input experience with smarter masking, better keyboard navigation, and full WCAG compliance.

    • Auto-format the input as the user types.
    • Full WCAG 2.1 AA compliance audit and remediation.
    • Screen reader announcements for date selection.
    • Focus trap management inside the popover.
  2. ⚡ React 19 & SSR improvements Research

    Ensure compatibility with React 19's concurrent features and improve server-side rendering support.

    • Test and certify compatibility with React 19.
    • Evaluate using React 19 APIs for form integration.
    • SSR-safe portal rendering without hydration mismatches.
  3. 🧪 Expanded test coverage Research

    Broaden the test suite to cover edge cases, browser interactions, and visual regressions.

    • Browser-level tests with Playwright for click-outside, keyboard, and popover positioning.
    • Property-based testing for date conversion edge cases.
    • Accessibility testing with axe-core integration.

✅ Shipped

  1. 🌐 Localization & disable rules Shipped

    Nepali (नेपाली) locale support and comprehensive date disable options — single dates, ranges, today, before/after.

  2. 🎨 Theming & CSS variables Shipped

    Customizable styling through CSS variables for font, popover sizing, and colors.

  3. 🔄 Overflow-safe popover Shipped

    Portal-based popover with viewport-aware positioning that works inside dialogs, drawers, and scroll containers.

Have an idea for the roadmap? Found a bug? Contributions are welcome!

🐛 Open an issue ⭐ Star on GitHub