Release Notes v1.0.7

Cheapest Energy Windows Dashboard - v1.0.7

🎨 Enhancements & Improvements

1. Cost Tracking Consolidation & Display Improvements

Enhanced: Streamlined cost display and improved visual clarity throughout the dashboard.

Problem:

• Cost Tracking section was redundant when base_usage=0, showing identical values to Daily Net Cost cards
• Daily cost cards had truncated text and unclear format
• Base Usage info card was unreadable due to text truncation

Changes Made:

Daily Cost Cards (Today & Tomorrow)

• Files:

  • cheapest_energy_windows_dashboard_yaml/dashboard.yaml (Lines 479-518, 1167-1194)
  • cheapest_energy_windows_dashboard/cew-dashboard-strategy.js (regenerated)

• Title: Changed from "Daily Net Cost" to "Daily Cost"

• Multi-line Display: Added multiline_secondary: true property to enable proper line breaks

• Format Enhancement:

  • Line 1: Current/Planned Cost display (e.g., "€6.19/€0.98" for Today, "€10.54" for Tomorrow)
  • Line 2: Window Progress (e.g., "30/53" showing completed/total windows)

• Before: Text truncated as "€8.8/€0.0 30..." on single line

• After: Clear two-line display with proper formatting

Cost Tracking Section Removal

• Files: cheapest_energy_windows_dashboard_yaml/dashboard.yaml
• Removed: ~54 lines of redundant Cost Tracking section
• Reason: When base_usage=0, displayed same values as Daily Cost cards
• Result: Cleaner dashboard, eliminated ~220 lines of complex template calculations

Base Usage Information Cards Split

• Files: cheapest_energy_windows_dashboard_yaml/dashboard.yaml (Lines 1686-1699)
• Before: Single card with ~195 characters causing truncation ("Track constant household power consumption (appliances, lights, et...")
• After: Two separate cards with clear, readable text:
  • Card 1: "Base Usage Feature" - Explains what it tracks
  • Card 2: "How to Configure" - Configuration guidance
• Impact: Users can now read full information without truncation

Impact:

• Clearer cost visibility with no text truncation
• Better organization and reduced complexity
• Improved user experience with readable information cards
• Dashboard automatically adjusts based on base_usage configuration

---

2. Template Robustness Improvements

Fixed: Enhanced template reliability to handle edge cases and missing attributes gracefully.

Issues Addressed:

1. Jinja2 Default Filter: Changed from or [] pattern to | default([], true) throughout dashboard

   • Problem: Using or [] broke operator precedence, causing "TypeError: object of type 'NoneType' has no len()"
   • Solution: | default([], true) properly handles both missing attributes AND None values
   • Example: state_attr('sensor.cew_today', 'actual_charge_times') | default([], true) | length

2. YAML Block Scalars: Changed from >- (folded) to | (literal) for multi-line output

   • Problem: >- treated \n as literal text instead of line breaks
   • Solution: | preserves actual line breaks in template output
   • Applied to: Daily Cost card secondary text (Today and Tomorrow)

Files Modified:

• cheapest_energy_windows_dashboard_yaml/dashboard.yaml (Multiple template locations)
• cheapest_energy_windows_dashboard/cew-dashboard-strategy.js (regenerated)

Impact:

• Templates handle None/missing values without errors
• Multi-line text displays correctly in cards
• More stable dashboard with better error handling

---

3. Planned Total Cost Integration

Added: Dashboard now displays planned total cost alongside current cost for better budget visibility.

Feature:

• Integrated new planned_total_cost attribute from Integration v1.0.7
• Shows estimated total daily cost for all planned windows (not just completed)

Display Format:

• Today's Daily Cost: "€8.80/€15.50" (current/planned)
• Tomorrow's Daily Cost: "€10.54" (planned only, no completed windows yet)

Files Modified:

• cheapest_energy_windows_dashboard_yaml/dashboard.yaml (Daily Cost cards)
• cheapest_energy_windows_dashboard/cew-dashboard-strategy.js (regenerated)

Impact:

• Users can see both current and projected costs side-by-side
• Better budget planning and energy usage insights
• Clear visibility into cost progression throughout the day

---

4. Repository URL Updates

Fixed: Updated GitHub organization references from old naming convention.

Changes Made:

• File: cheapest_energy_windows_dashboard/info.md (Line 10)
• Updated: Integration link from github.com/cew-hacs/... to github.com/cheapest-energy-windows/...

Impact:

• HACS displays correct repository organization name
• Documentation links point to correct GitHub location
• Consistent with Integration v1.0.7 URL updates

---

📋 Deployment Instructions

Option 1: HACS Installation (Recommended)

1. Update the dashboard through HACS
2. Hard refresh your browser: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows/Linux)
3. Verify multi-line display in Daily Cost cards

Option 2: Manual Installation

1. Copy cew-dashboard-strategy.js to:
   • /config/www/community/cheapest_energy_windows_dashboard/
2. Clear browser cache and refresh dashboard
3. Verify all cost displays and multi-line formatting

---

🔄 Dashboard Configuration Notes

Requirements:

• Cheapest Energy Windows Integration v1.0.7 (required for planned_total_cost attribute)
• ApexCharts Card
• Mushroom Cards
• Card Mod
• fold-entity-row

Compatibility:

• Fully compatible with Integration v1.0.7
• Backward compatible with base_usage=0 configurations
• No dashboard configuration changes required

New Features Available with v1.0.7:

• Planned total cost display
• Improved cost tracking visibility
• Enhanced multi-line card displays
• More robust template handling

---

📝 Technical Changes Summary

Files Modified (6 files)

1. cheapest_energy_windows_dashboard_yaml/dashboard.yaml - Core dashboard configuration
2. cheapest_energy_windows_dashboard/cew-dashboard-strategy.js - Generated JavaScript
3. cheapest_energy_windows_dashboard/info.md - Repository documentation

Lines Changed

• Added: multiline_secondary: true to 2 Daily Cost cards
• Updated: Multiple template patterns (| default([], true))
• Updated: YAML block scalars (| instead of >-)
• Removed: ~54 lines of redundant Cost Tracking section
• Split: Base Usage info into 2 cards
• Modified: Daily Cost card templates and formatting

Key Template Patterns

# Proper default handling
{{ state_attr('sensor.cew_today', 'actual_charge_times') | default([], true) | length }}

# Literal block scalar for multi-line output
secondary: |
  {% set current = state_attr('sensor.cew_today', 'total_cost') | float(0) %}
  {{ '€' + (current | round(2) | string) }}
  {{ completed }}/{{ total_windows }}

# Enable multi-line display
multiline_secondary: true

---

Version: 1.0.7
Companion Integration Version: 1.0.7
Repository: cheapest_energy_windows_dashboard
Generated JS Size: 130.30 KB

Cheapest Energy Windows Dashboard - v1.0.6

🐛 Bug Fixes & Improvements

1. Dashboard Price Charts Not Reacting to Price Settings Changes

Fixed: Price charts for Today and Tomorrow now properly react to changes in VAT, tax per kWh, and additional cost settings.

• Files:
  • cheapest_energy_windows_dashboard_yaml/dashboard.yaml (Lines 404-415, 1174-1185, 365-374, 1135-1143)
  • cheapest_energy_windows_dashboard/cew-dashboard-strategy.js (generated)
• Issues Fixed:
  1. Charts didn't refresh when price settings changed - added hidden trigger entities for number.cew_vat, number.cew_tax, and number.cew_additional_cost
  2. Setting tax or additional cost to 0 would trigger hardcoded fallbacks - changed logic from || hardcoded_value to || 0
  3. Removed arbitrary fallback values (VAT: 0.21, Tax: 0.12286, Additional: 0.02398) - all now default to 0 if unavailable
• Impact: Price charts now immediately update when any price setting is changed, and correctly accept 0 as a valid value

2. Tomorrow Chart Override Display - Fixed Incorrect Entity Usage

Fixed: Tomorrow's ApexChart now correctly displays today's settings when Tomorrow Settings is disabled.

• Issue: When Tomorrow Settings was OFF, the tomorrow chart still displayed tomorrow's time override settings instead of today's settings

  • Example: With Tomorrow Settings OFF, the chart would show tomorrow's time override visualization even though the calculation correctly used today's settings
  • Root Cause: The chart always read switch.cew_time_override_enabled_tomorrow and related entities directly

• Files:

  • cheapest_energy_windows_dashboard_yaml/dashboard.yaml (Lines 952-966)
  • cheapest_energy_windows_dashboard/cew-dashboard-strategy.js (generated)

• Changes:

  • Added check for switch.cew_tomorrow_settings_enabled state
  • When Tomorrow Settings is OFF: Chart uses today's entities (switch.cew_time_override_enabled, etc.)
  • When Tomorrow Settings is ON: Chart uses tomorrow's entities (switch.cew_time_override_enabled_tomorrow, etc.)
  • Chart visualization now matches what the calculation engine actually uses

• Impact: Tomorrow's price chart correctly reflects the settings that will actually be applied

3. Battery Activity Display Format - Added kWh Progress Tracking

Enhanced: Battery activity cards now show both energy values (kWh) and window completion progress.

• Files:
  • cheapest_energy_windows_dashboard_yaml/dashboard.yaml (Lines 2014-2015, 2058-2059, 2230, 2271-2272)
  • cheapest_energy_windows_dashboard/cew-dashboard-strategy.js (generated)
• Changes:
  • Before: 50.4 kWh (6/7) - showed total kWh with window counts
  • After: 21.6kWh/50.4kWh (6/7) - shows actual kWh charged/discharged vs planned, plus window progress
• Applies to:
  • Today's Planned Charging
  • Today's Planned Discharge
  • Tomorrow's Planned Charging
  • Tomorrow's Planned Discharge
• Impact: Users can now see exactly how much energy has been charged/discharged in addition to window completion counts

---

Cheapest Energy Windows Dashboard - Release v1.0.5

🌟 Highlights

This release adds the Battery Operations Panel for zero-YAML battery control and ENTSO-E Support with full chart compatibility. Tomorrow settings display also improved.

✨ New Features

• 🔋 Battery Operations Panel (Major Feature): Link your battery control without editing YAML

  • Dropdown selectors for each mode (charge, discharge, aggressive discharge, idle, off)
  • Choose from your existing automations, scripts, or scenes
  • Visual feedback showing linked operations
  • Works with any home battery that can be automated in Home Assistant
  • No more manual YAML editing required!

• 🌍 ENTSO-E Support (Major Feature): Full dashboard support for ENTSO-E price sensors

  • All charts now work with ENTSO-E sensors via proxy sensor
  • Automatic data normalization for consistent display
  • Seamless experience whether using Nord Pool or ENTSO-E
  • No configuration needed - works automatically with integration v1.0.5

🔧 Improvements

• Performance Improvements: Significantly faster and more responsive dashboard

  • Removed polling for configuration changes
  • Dashboard now updates reactively when settings change
  • Instant UI updates without manual refresh
  • Reduced browser load and improved battery life on mobile devices
  • No more periodic background polling

• Tomorrow Settings Display: Better handling of tomorrow settings in the dashboard

  • Settings are now correctly displayed after midnight rotation
  • Improved refresh behavior when settings change

🐛 Bug Fixes

• Fixed tomorrow settings not updating properly in the UI after rotation

🔄 Upgrading

1. Update via HACS
2. Clear browser cache (Ctrl+Shift+R or Cmd+Shift+R)
3. Refresh dashboard

📝 Notes

• Requires integration v1.0.5 for Battery Operations panel and ENTSO-E support
• ⚠️ Breaking change: The battery control automation is now auto-managed - manual edits will be overwritten
• If you previously edited the automation manually, you'll need to reconfigure battery actions through the Battery Operations panel after upgrade
• Configure battery actions through the dashboard panel - manual automation edits will be overwritten
• Full support for both Nord Pool and ENTSO-E price sensors
• Version synchronized with integration for consistent experience

Dashboard Release Notes v1.0.3

New Features

• Added cost/revenue totals next to window counts
  • Shows calculated costs for charge windows (e.g., "• Cost: €6.49")
  • Shows calculated revenue for discharge windows (e.g., "• Revenue: €7.22")

Bug Fixes

• Fixed Tomorrow's spread displaying 0% instead of actual percentage value
• Fixed charge window visualization disappearing when no discharge windows present
• Improved chart theme compatibility (removed hardcoded white colors for y-axis labels)

Enhancements

• Improved "data not available" messaging
  • Larger, bold text (20px) for better visibility
  • Clearer time window: "Becomes available between 13:00-15:00 CET"
  • Better vertical centering of message

v1.0.2 - HACS Submission

Release for HACS default store submission

Dashboard Strategy for Cheapest Energy Windows

• Complete dashboard with energy optimization visualizations
• Nord Pool pricing charts
• Battery charge/discharge windows
• Energy consumption tracking

Installation:
Install via HACS as a frontend plugin, then create dashboard using the strategy.

Required Cards:

• Mushroom Cards
• ApexCharts Card
• Fold Entity Row
• Card Mod