Skip to content

v2.8.0

Choose a tag to compare

@github-actions github-actions released this 16 Jun 17:16

Highlights

v2.8.0 closes two gaps in how the card communicates what the integration is doing. When the integration throttles consecutive adjustments, the decision strip now shows a live countdown — the exact seconds until the next adjustment is allowed — so the cover sitting still is no longer a silent mystery. The covers bar and sky compass get a round of label and marker fixes: during a manual override, the would-be solar target is labeled distinctly rather than sharing the plain "Target" label with a held position, the target marker no longer clips past the rail endpoints at 0% and 100%, and the compass legend gains a separate "held" row when the actual cover position diverges from the target, making it possible to see at once where the cover sits versus where automation would send it.

Added

  • Throttle countdown in decision strip (src/components/decision-strip.ts, src/lib/formatters.ts, src/types.ts, src/lib/i18n/en.ts, src/lib/i18n/fr.ts) — DecisionStrip now renders a .throttle-countdown banner showing the decision.next_change_in string ("Next adjustment allowed in {time}") when the integration is holding back an adjustment. The countdown derives from the last-skipped action via _throttleNextAllowedIso(), feeds into the existing countdownTo formatter, and ticks via _syncTimer() once per second; the banner disappears automatically once the throttle window clears. LastSkippedAttributes carries the new throttle fields on the integration side; cards running against older integration builds render exactly as before, since the banner only appears when those fields are present. The new nextAllowedIso formatter is unit-tested alongside countdownTo. Refs #163, PR #165.

Changed

  • Target label and marker fixes in covers bar (src/components/cover-bar.ts, src/lib/i18n/en.ts, src/lib/i18n/fr.ts) — During a manual-override divergence, CoverBar now labels the solar would-be position using covers.target_solar rather than the plain covers.target label, paired with an override-specific tooltip via covers.target_tooltip_override. The target marker also picks up an inline clamp and translateX(-50%) centering so it no longer overflows the rail at the 0% and 100% extremes. Refs #158, PR #164.

  • Compass legend second row for held position (src/components/sky-compass.ts, src/lib/i18n/en.ts, src/lib/i18n/fr.ts) — SkyCompass now computes a showHeld boolean and, when the actual cover position diverges from the target, renders a second legend row with a .cover-actual-swatch glyph under the existing target row. The retired compass.cover_position key is replaced by compass.cover_target and compass.cover_held. The window-normal entry is relabeled "Window azimuth". Refs #158, PR #164.

Compatibility

  • Home Assistant 2024.1+
  • Adaptive Cover Pro integration v2.22.1-beta.3 or newer for full functionality
  • The throttle countdown activates only when the companion integration exposes the throttle fields on the last-skipped action; the card renders gracefully without them
  • No config migration needed

Install / Upgrade

Through HACS, update to v2.8.0. A browser restart is not required.

HA caches ES modules aggressively. After updating, bump the ?v=2.8.0 query string on your Lovelace resource URL (/hacsfiles/adaptive-cover-pro-card/adaptive-cover-pro-card.js?v=2.8.0) to ensure browsers pick up the new bundle. A hard-refresh alone is not sufficient.