Stable cut of the 3.5 line. Same commit as v3.5.0-RC1 — promoted to stable after smoke testing. Consolidates 3.5.0-alpha, 3.5.0-alpha2, and 3.5.0-beta1.
US-only data in the new overlays — see the strong life-safety disclaimers in docs/overlays.md.
Highlights
New: hazard overlays (US-only)
- Wildfire perimeter overlay (
show_wildfires: true) — active US wildfire perimeters from NIFC's WFIGS Current Interagency Fire Perimeters feed. Active fires draw red, fully-contained ones grey. Small incidents render as a fire icon at the centroid; larger ones as a polygon outline. Click any fire for a popup with name, acreage, containment %, discovery date, and a link to NIFC's InciWeb (gated against InciWeb's RSS index so we don't link to 404s). Adaptive 5/30-minute refresh. Filter knobs:wildfire_min_acres(default 10),wildfire_radius_km, plus colour / fill / refresh overrides. - NWS watches & warnings overlay (
show_alerts: true) — active US National Weather Service watches and warnings fromapi.weather.gov/alerts/active, rendered as translucent polygons coloured per NWS's standard warning palette. Both polygon-bearing and zone-based alerts render: zone shapes are fetched on-demand fromapi.weather.gov/zones/...and cached in localStorage (TTL 30 days) so they're zero-network on subsequent sessions. Click any alert for a popup with event, headline, severity / certainty / urgency, effective and expiry windows, full description, and a link to weather.gov. - Hazard Overlays editor subpage — new top-level "Markers and Overlays" section groups the existing Markers list and the new Hazard Overlays subpage, which exposes per-overlay knobs and a 2-column grid of NWS alert-category checkboxes.
- Region warnings — banner when any US-only feature is enabled with
hass.config.country !== 'US'(multiple US-only features collapse into a single combined banner). New: separate banner for DWD selected outside its coverage (Germany + immediate neighbours: NL, BE, LU, FR, CH, AT, CZ, PL, DK), replacing the developer-facing one-shotconsole.warnfrom 3.4.0 with a visible UI cue.
Time-range editor (replaces frame_count)
past_minutes/forecast_minutes— source-agnostic time-range fields. Editor offers preset dropdowns filtered by per-source caps: RainViewer and NOAA show20 / 40 / 60 / 120 min(cap 2 h); DWD shows up to 12 h. YAML can reach the API cap (DWD: 84 h, paired withframe_stride_minutes).- Forecast Duration field appears only on sources with a forecast (currently DWD:
Off / 1 h / 2 h); hidden in the DOM otherwise. frame_stride_minutes— YAML-only escape hatch for very large past windows on DWD.SOURCE_CAPStable insrc/source-caps.ts— single source of truth for per-source intervals, caps, and defaults.- Auto-migration — legacy
frame_countanddwd_forecast_hourssilently convert on load; existing configs need no changes.
Animation polish
smooth_overlap(0–1) — tunable crossfade overlap whensmooth_animation: true. Sequential (no brightness dip) at0, fully simultaneous (default; brief mid-transition dip) at1. Editor exposes a slider with mutual gating againsttransition_time.- Trail-on-first-cycle and editor-open detection races fixed.
Quality-of-life — three contributions from @genericJE
- Loading spinner in the bottom bar while tiles are fetching (#124).
- "Now" marker on the progress bar — useful when DWD forecast frames push "now" away from the rightmost edge (#125).
- Dark / satellite map scale text-shadow fix (#123).
Other notable changes
- WYSIWYG map editing — pan/zoom in the live map auto-propagates to the editor's Lat/Long/Zoom fields. The "Save as map center" button is gone.
- Card-picker preview — static preview image in HA's card-add picker.
- Sections-grid support —
getGridOptions()plus a flex layout that fills any cell, with a responsive bottom row that hides the date prefix on narrow cards. - Pause when hidden — wildfire and NWS-alerts layers stop their refresh timers when the card is off-screen or the tab is hidden, refetching on resume if stale.
- Dynamic radar tile size — picks 256 / 512 / 1024 / 2048 from
map.getSize()so panel-view / fullscreen maps load with bigger tiles (fewer requests for the same coverage). - Build timestamp in console signon — confirms a hard refresh actually loaded the new bundle.
Documentation
- 495-line README split into a slim landing page plus focused docs under
docs/(Configuration, Data Sources, Hazard Overlays, Markers, Examples, Animation architecture). docs/animation.mdrewritten to match the actual two-slot + delayed-fade-out model.- New design docs for the wildfire and NWS-alerts overlays.
Localization
11 language files now at 100% key parity. Brand acronyms (NWS, NOAA, NIFC) and the "Acres" US unit intentionally retained in source form.
Tests
128 → 268 unit tests (140 added).
Recent breaking changes
No breaking changes in 3.5.0. frame_count and dwd_forecast_hours are deprecated (auto-migrated, deprecation warning logged) but continue to work.
For context on prior breaking changes, see the 3.1.0 (multi-marker overhaul) and 3.0.0 (Leaflet bundled, iframe removed, native LitElement) entries in the CHANGELOG.
Full notes: CHANGELOG.md