plotly-caplot continuation

[thomazyujibaba]

I’m continuing the development of the plotly-calplot project under the repository
https://github.com/thomazyujibaba/plotly-calheatmap

Several improvements and new features have already been implemented, including:

1. Built-in aggregation — pass raw event data with agg="sum" | "mean" | "count" | "max" instead of pre-aggregating
2. Vertical orientation — render months as rows using vertical=True
3. Hourly heatmap — hourly_calheatmap() for hour × day grids per month
4. Month gap spacing — extra visual separation between months via month_gap
5. Multi-year support with independent tick configurations per subplot
6. Year navigation buttons (navigation=True)
7. Localization support (locale parameter) for month and day names (e.g. pt_BR, es, fr)
8. Customizable hovertemplate with friendly {placeholder} syntax and customdata columns
9. Fully customizable colorscales, including custom color lists
10. Month separator lines, configurable month label placement, and color scale with labels and ticks
11. Flexible layout options: gap, margin, font_*, paper_bgcolor, plot_bgcolor, and more

Special thanks to @brunorosilva for the original project and foundation that made this continuation possible 🙏