feat: add support for broadcast calendar

[Nradar]

Broadcast Calendar Support

Overview

This pull request introduces support for the Broadcast Calendar feature in the DayPicker component. The Broadcast Calendar is designed to accommodate specific scheduling needs, particularly in broadcasting and media contexts, where weeks may not align with traditional calendar weeks.

Key Changes

1. Broadcast Calendar Prop:

   • Added a new prop broadcastCalendar to the DayPicker component, allowing users to enable the Broadcast Calendar functionality.

2. Date Calculations:

   • Implemented helper functions getBroadcastStartDate and getBroadcastEndDate in getBroadcastCalendar to calculate the start and end dates of the broadcast weeks based on the first day of the month.
   • Adjusted the logic in the getMonths function to utilize these new helper functions when broadcastCalendar is true.

3. UI Integration:

   • Updated the DayPicker component to conditionally render the calendar based on the broadcastCalendar prop, ensuring that the UI reflects the correct week structure.

4. Documentation:

   • Updated the documentation to include details about the new broadcastCalendar prop, including examples of how to use it in the DayPicker component.

5. Localization Support:

   • Ensured that the Broadcast Calendar feature respects localization settings, allowing for proper display in different languages and regions.

More information about broadcast calendar, please refer to https://en.wikipedia.org/wiki/Broadcast_calendar

[gpbl]

That’s an interesting idea, @Nradar. Thanks for proposing it. I wasn’t aware of such calendars before.

[Nradar]

That’s an interesting idea, @Nradar. Thanks for proposing it. I wasn’t aware of such calendars before.

Thank you for your feedback! The broadcast calendar is what my company uses for scheduling, so I thought it might be helpful to others as well. I hope the pull request meets the project’s needs, and I’m happy to make any changes if needed to get it approved. 😊

[gpbl]

@Nradar, this looks great! Thanks for your efforts. I’ve updated the function names and other things to align with our conventions.

There are a few improvements that need to be made to the tests. I can address these personally in another pull request.