v4.11.1

✨ Daylight Calendar Card v4.11.1

Patch Release: This release focuses on UI polish and stability fixes with no configuration changes required.

⚠️ Fixes / Behavior Changes

• Header Layout Stability

  • Fixed a header layout flash that could occur when header controls were rerendered.
  • Improves visual stability during updates and navigation.

• Week Compact Event Title Wrapping

  • Long event titles in Week Compact view now wrap correctly instead of overflowing their event boundaries.
  • Improves readability for calendars with lengthy event names.

---

📚 Documentation Improvements

• General documentation updates and clarifications.

---

✅ Breaking Changes

• None.

---

🔗 Full Changelog

v4.11.0...v4.11.1

v4.11.0

✨ Daylight Calendar Card v4.11.0

🆕 New Features

• Custom Grid & Divider Color (grid_color)

  • Customize Month/Week Compact grid lines, Schedule dividers/hour lines, and Agenda separators.
  • Supports standard CSS colors and CSS variables.

• Header-Only Weather (show_daily_weather_forecast)

  • Disable per-day forecasts while keeping current weather conditions in the header.
  • Defaults to true, preserving existing behavior.

• Week Compact Header Customization

  • week_compact_weekday_font_size
  • week_compact_weekday_color
  • week_compact_day_header_spacing
  • Fine-tune weekday typography and vertical spacing specifically for Week Compact view without affecting other views.

• Event Display Title Alias (event_styles.style.display_title)

  • Replace long event titles with a custom display-only title while keeping the original title for matching, event details, and editing.

---

⚠️ Fixes / Behavior Changes

• Home Assistant Theme Integration

  • Restored proper inheritance of --ha-card-background, border radius, border width/color, and box shadow.
  • Explicit Daylight overrides still take precedence.

• Transparent Background Improvements

  • background_opacity: 100 and background_transparent: true now make internal calendar surfaces fully transparent.
  • Fixed transparent Month/Week Compact grid separators so the dashboard background properly shows through.

• Agenda Layout Fix

  • Agenda events now expand automatically for wrapped titles and locations.
  • Compact agenda events remain tightly content-sized.

• Recurring Event Reliability

  • Fixed recurring events whose recurrence_id is returned by Home Assistant as an object, preventing occurrence collisions, incorrect deduplication, and custom-color conflicts.

• Event Cache Compatibility

  • Cache snapshot schema was refreshed for corrected recurrence identities while the IndexedDB database remains at version 1, so no database migration is required.

---

📚 Documentation & Testing

• Expanded documentation for themes, grid_color, event title aliases, daily weather controls, and Week Compact header options.
• Updated Playwright visual baselines and expanded regression coverage across themes, transparency, agenda sizing, weather, and compact layouts.

---

✅ Breaking Changes

• None.
• Existing configurations retain their current defaults.
• Custom themes that previously relied on workarounds for broken Home Assistant theme inheritance may render differently now that HA theme variables are correctly honored.

---

🔗 Full Changelog

v4.10.0...v4.11.0

v4.10.0

✨ Daylight Calendar Card v4.10.0

Important

Were you using this card before the rename from Skylight Calendar Card?

Please check Settings → Dashboards → Resources and remove any old Skylight resource:

❌ /hacsfiles/skylight-calendar-card/skylight-calendar-card.js

Keep only the current Daylight resource:

✅ /hacsfiles/daylight-calendar-card/skylight-calendar-card.js

The filename is still skylight-calendar-card.js; the folder should be daylight-calendar-card.

Stale resources can make new features appear missing or broken even when HACS shows the latest version. See the troubleshooting guide:
https://docs.daylightcalendar.com/troubleshooting#updated-to-the-latest-version-but-still-seeing-old-behavior

🆕 New Features

• Custom Neutral Background for Combined Events (combine_events.background_color)

  • Added support for specifying a custom neutral background color when using combined events.
  • Allows combined events to better match your dashboard theme while maintaining calendar color indicators.

• Configurable Week Number Prefix (week_number_prefix)

  • Customize the text displayed before month-view week numbers (for example, W, Week, or a localized prefix).
  • Also resolves incorrect Dutch week labels.

---

⚠️ Fixes / Behavior Changes

• Recurring Event Fixes

  • Fixed an issue where recurring event weekdays were not always evaluated correctly.

• Event Modal Improvements

  • Fixed button overflow in the event details modal on smaller displays.

• Header Layout Improvements

  • Eliminated unnecessary header spacing when the calendar title is left blank, allowing cleaner minimalist layouts.

---

📚 Documentation Improvements

• Added documentation for:
  • week_number_prefix
  • Blank title behavior

---

🙌 New Contributors

• Thanks to @ajbw for adding customizable neutral background colors for combined events!
• Thanks to @MKPmncoder for fixing recurring event handling and event modal layout issues!

---

🔗 Full Changelog

v4.9.1...v4.10.0

v4.9.1

✨ Daylight Calendar Card v4.9.1

Patch Release: This release resolves a startup race condition that could cause calendar events to appear empty after refreshing certain Home Assistant Masonry dashboards. Event loading now resumes immediately when Home Assistant temporarily disconnects and reconnects the card, instead of waiting for the next refresh interval.

⚠️ Fixes / Behavior Changes

• Reliable Event Loading

  • Fixed a startup race where calendar events could remain empty after dashboard refreshes.
  • Event loading now resumes immediately after the card reconnects to Home Assistant.

• Reconnect Data Preservation

  • Fresh per-calendar event data is now preserved during reconnects, preventing newer data from being overwritten during cache hydration.

• Week Compact Layout Fixes

  • Resolved overflow issues in Week Compact view.
  • Expanded compact_height compatibility and regression test coverage.

---

🔧 Maintenance

• Updated Playwright visual baselines.
• Internal maintenance and release preparation.

---

🔗 Full Changelog

v4.9.0...v4.9.1

v4.9.0

✨ Daylight Calendar Card v4.9.0

Important

Were you using this card before the rename from Skylight Calendar Card?

Please check Settings → Dashboards → Resources and remove any old Skylight resource:

❌ /hacsfiles/skylight-calendar-card/skylight-calendar-card.js

Keep only the current Daylight resource:

✅ /hacsfiles/daylight-calendar-card/skylight-calendar-card.js

The filename is still skylight-calendar-card.js; the folder should be daylight-calendar-card.

Stale resources can make new features appear missing or broken even when HACS shows the latest version. See the troubleshooting guide:
https://docs.daylightcalendar.com/troubleshooting#updated-to-the-latest-version-but-still-seeing-old-behavior

🆕 New Features

• Custom Event Colors (event_colors)

  • Override Home Assistant calendar colors with custom local colors.
  • Customize the appearance of individual calendars while preserving all existing styling features.

• Persistent Event Cache

  • Added a persistent "last-known-good" event cache with stale-while-revalidate loading.
  • Calendar data remains visible during temporary Home Assistant outages or slow reloads, resulting in a faster and more resilient experience.

• Custom Header Items (header_items)

  • Add structured custom content to the calendar header.
  • Supports configurable text, icons, sensors, and other header elements for highly personalized dashboards.

• Estonian Localization (language)

  • Added Estonian (et) language support.

---

⚠️ Fixes / Behavior Changes

• Improved Event Fetch Reliability

  • Added retry throttling after complete calendar fetch failures to reduce unnecessary network requests during outages.

• Event Modal Behavior

  • Prevent accidental dismissal by clicking the modal backdrop.

• Translation Improvements

  • Normalized translation strings and added missing entries for new color-related features.

• Build & Dependency Improvements

  • Fixed Rollup optional native lockfile handling for more reliable builds across platforms.

---

📚 Documentation Improvements

• Added documentation for:
  • Custom event colors
  • Persistent event cache
  • Custom header items
• Improved bug report template with additional troubleshooting guidance.

---

🙌 New Contributors

• Thanks to @LiivaneLord for adding Estonian language support!

---

🔗 Full Changelog

v4.8.0...v4.9.0

v4.8.0

✨ Daylight Calendar Card v4.8.0

Important

Were you using this card before the rename from Skylight Calendar Card?

Please check Settings → Dashboards → Resources and remove any old Skylight resource:

❌ /hacsfiles/skylight-calendar-card/skylight-calendar-card.js

Keep only the current Daylight resource:

✅ /hacsfiles/daylight-calendar-card/skylight-calendar-card.js

The filename is still skylight-calendar-card.js; the folder should be daylight-calendar-card.

Stale resources can make new features appear missing or broken even when HACS shows the latest version. See the troubleshooting guide:
https://docs.daylightcalendar.com/troubleshooting#updated-to-the-latest-version-but-still-seeing-old-behavior

🆕 New Features

• Continuous Multi-Day Event Spans

  • Multi-day all-day events are now rendered as a single continuous span in both Month and Schedule views for a cleaner, more intuitive display.

• Clickable Event Locations (location_tap_action)

  • Event locations in the event details modal can now be tapped to launch maps or perform other configured actions.

• Interactive Day Badges (day_badges.tap_action)

  • Day badges now support YAML tap_action definitions, including fire-dom-event, enabling custom interactions and dashboard automations.

• Month Day Tap Action (month_day_tap_action)

  • Configure what happens when tapping a day in Month view, including opening that day's events directly.

---

⚠️ Fixes / Behavior Changes

• Month View Layout Improvements

  • Fixed compact-height overflow for multi-day event spans.
  • Improved +N more counting when continuous event spans are present.

• Documentation & Testing

  • Updated Playwright visual baselines.
  • Minor documentation grammar and typo improvements.

---

🔗 Full Changelog

v4.7.0...v4.8.0

v4.7.0

✨ Daylight Calendar Card v4.7.0

Important

Were you using this card before the rename from Skylight Calendar Card?

Please check Settings → Dashboards → Resources and remove any old Skylight resource:

❌ /hacsfiles/skylight-calendar-card/skylight-calendar-card.js

Keep only the current Daylight resource:

✅ /hacsfiles/daylight-calendar-card/skylight-calendar-card.js

The filename is still skylight-calendar-card.js; the folder should be daylight-calendar-card.

Stale resources can make new features appear missing or broken even when HACS shows the latest version. See the troubleshooting guide:
https://docs.daylightcalendar.com/troubleshooting#updated-to-the-latest-version-but-still-seeing-old-behavior

🆕 New Features

• Calendar Time Zone Override (time_zone)
  Display the calendar using a specific time zone instead of Home Assistant's default. Useful for travel, remote teams, or calendars in different regions.

• Week Day Badge Layout (day_badge_layout)
  Added a new layout option for displaying day badges in week views, providing greater flexibility for dense schedules.

• Stale Resource Warning
  Added a dismissible banner that helps detect old pre-rename Skylight resources and points users to the fix.

---

⚠️ Fixes / Behavior Changes

• Improved Time Zone Handling

  • Fixed timezone calculations for synthetic display dates.
  • Corrected handling of all-day events when using custom time zones.

• Compact Header Stability

  • Fixed a resize oscillation issue that could occur with compact headers.

• Event Modal Rendering

  • Prevent unnecessary resize-triggered rerenders while the event modal is open, improving stability during editing.

---

🔧 Internal Improvements

• Migrated the project to a modular src/ architecture with a Rollup build system.
• Extracted rendering, weather, editor, event handling, styling, configuration, and utility logic into dedicated modules.
• Expanded automated testing and developer documentation.

These changes are internal only and do not introduce any breaking configuration changes.

---

📚 Documentation Improvements

• Added troubleshooting guidance for common display issues.
• Clarified documentation for:
  • compact_height
  • Font display options
  • time_zone
  • Stale HACS frontend resources

---

🔗 Full Changelog

v4.6.0...v4.7.0

v4.6.0

✨ Daylight Calendar Card v4.6.0

🆕 New Features

• Configurable Event Modal Size (event_modal_size)
  Control the size of the event details modal to better fit different devices and dashboard layouts.

• Full Localized Weekday Names (display_full_weekday_names)
  Display full weekday names (e.g., "Monday" instead of "Mon") using your configured locale.

• Enhanced Day Badges (day_badges)

  • Support displaying both an icon and text within the same badge
  • Dynamically populate badge text from matched event metadata
  • Enables richer visual indicators such as school days, work schedules, appointments, and custom event-derived labels

• Shared Advanced Matching Rules (event_styles, day_styles, day_badges)

  • Added a common advanced matching engine across styling and badge features
  • Improves consistency and expands future rule capabilities across all matching systems

---

⚠️ Fixes / Behavior Changes

• Header Color Fallback Fix

  • Corrected wrapped-header color fallback behavior in certain layouts and themes.

• Typography Isolation Improvements

  • Scoped calendar typography styles to prevent unintended styling interactions with surrounding dashboard content.

---

📚 Documentation Improvements

• Introduced the new Mintlify documentation site
• Added documentation for:
  • event_modal_size
  • display_full_weekday_names
• Improved troubleshooting, FAQ, and behavior documentation

---

🙌 New Contributors

• Thanks to @mintlify[bot] for its first contribution to the project!

---

🔗 Full Changelog

v4.5.0...v4.6.0

v4.5.0

✨ Daylight Calendar Card v4.5.0

📖 Documentation is now available at https://docs.daylightcalendar.com

🆕 New Features

• Past Event Matching for Event Styles (event_styles)

  • Added past matcher support for targeting past events.
  • Supports safe visual effects including opacity and CSS filter styling.

• Shortened Event Time Labels (shorten_event_times)

  • Option to display more compact event times for improved readability in dense calendars.

• Event Icons (event_styles)

  • Add custom icons to events through event_styles.
  • Icons are rendered consistently across supported calendar views.

• Today Styling Shortcuts

  • today_background_color
  • today_style

  Added convenient options for quickly customizing the appearance of the current day without creating full day_styles rules.

• Virtual Calendar Editor Support (virtual_calendars)

  • Virtual calendars can now be configured directly through the visual editor.

• Danish Localization (language)

  • Added Danish (da-DK) language support.

---

⚠️ Fixes / Behavior Changes

• Sections View Layout Improvements

  • Improved grid height handling and compact sizing behavior when used inside Home Assistant Sections layouts.

• Event Modal Layering Fix

  • Fixed cases where the event modal could appear above the Home Assistant header.

• Configuration & Validation Improvements

  • Refactored configuration normalization into a schema-driven system.
  • Improved handling and validation of enums, CSS lengths, and font sizes.
  • Expanded automated test coverage for YAML-facing configuration options.

---

📖 Documentation

• New Documentation Site

  • Documentation is now available at https://docs.daylightcalendar.com/
  • Reorganized and expanded documentation covering views, configuration options, advanced styling, troubleshooting, and FAQs.
  • Added dedicated documentation pages for features such as event_styles, day_styles, day_badges, virtual calendars, and combined calendars.

• Troubleshooting Improvements

  • Expanded troubleshooting guidance and common issue resolution steps.
  • Updated repository documentation to point to the new documentation site.

---

🛠️ Project Maintenance

• Added broader automated coverage for user-facing YAML configuration options.
• Continued internal cleanup and normalization refactoring to improve long-term maintainability and reliability.

---

🔗 Full Changelog

v4.4.0...v4.5.0

v4.4.0

Highlights

• Deprecated max_events runtime enforcement and removed the editor option. (#325)
  Breaking Change: If you previously relied on the max_events setting, you may need to adjust your configuration.
• Added support for default_hidden_calendars, including normalization, editor UI, and persistence. (#342)

Fixes

• Fixed header wrap detection for compact/standard headers and added regression tests. (#327)
• Improved header wrap detection using natural widths and centered compact wrapped header groups. (#330)
• Introduced ResizeObserver for headers to recalculate