Roadmap
What's coming next for bos-nepali-date — planned features, improvements, and the long-term vision.
Last updated: June 2026🔄 In progress
-
📦 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
-
📅 Range picker + dual calendar view Planned
A new
NepaliDateRangePickercomponent 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.
-
📖 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
-
⌨️ 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.
-
⚡ 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.
-
🧪 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
-
🌐 Localization & disable rules Shipped
Nepali (नेपाली) locale support and comprehensive date disable options — single dates, ranges, today, before/after.
-
🎨 Theming & CSS variables Shipped
Customizable styling through CSS variables for font, popover sizing, and colors.
-
🔄 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