Migration Guide

This page gives a safe structure for documenting breaking changes as the package evolves.

v1 → v2

What changed

• Component props were normalized.
• TypeScript definitions were improved.
• Styling hooks were made more predictable.

Suggested upgrade steps

1. Upgrade the package.
2. Replace deprecated prop names.
3. Run TypeScript checks.
4. Verify controlled and uncontrolled usage.

npm install nepali-bs-calendar-react@latest

v2 → v3

What changed

• Documentation now recommends wrapper components for app-specific behavior.
• The public API is organized around Calendar and DatePicker use cases.
• Styling examples are aligned with modern React and Tailwind projects.

Suggested upgrade steps

1. Read the API reference.
2. Update imports if export names changed.
3. Confirm date value shape in your forms.
4. Add regression tests for date selection flows.

Compatibility checklist

• Calendar renders in client components.
• Date values are saved in the expected format.
• Disabled, minimum, and maximum dates work as expected.
• Dark mode styling remains readable.