Clean up 2026.9.0 additions: comments, dead refs, storm perf

Strip issue/version numbers from code comments, drop stale dev-console
references, and remove leftover phase-plan wording (the multi-tariff cost
is handled by the stat_cost path, not later). Rename the corner-chip
dimmed flag to hidden to match its visibility:hidden behaviour. Guard the
thunderstorm controller so it only writes --wx-flash when the value
changes, sparing a per-frame style recalc during the gaps between strikes.
Surface the cost detail-panel cumulative total in the changelog.

Author: ReikanYsora

CHANGELOG.md

@@ -11,7 +11,7 @@ and the project follows a date-based versioning scheme (`YEAR.MONTH.PATCH`).
 
 The weather release, "Your real sky": the scene now reflects the weather over
 your home, and the outdoor temperature and humidity join the card. Currently in
-alpha (`2026.9.0-a5`).
+alpha (`2026.9.0-a6`).
 
 ### Added: a cost chip
 
@@ -34,7 +34,9 @@ own per-tariff cost statistics and sums them. And the chip is **fully in the
 editor** now, show or hide it, and pick its colour and icon, like every other
 chip. The chip **follows the timeline** as you scrub (the cost at the hovered
 moment, like the other chips), and its **day curve around the house** now draws
-for multi-tariff grids too, not just a fixed price.
+for multi-tariff grids too, not just a fixed price. Open its detail panel for the
+cumulative total over the selected period, what you spent, what you earned, and
+the net.
 
 ### Added: the real weather, painted over the scene
 

dist/helios.js

@@ -1,6 +1,6 @@
 {
   "name": "helios",
-  "version": "2026.9.0-a5",
+  "version": "2026.9.0-a6",
   "description": "HELIOS - real-time solar exposure, cloud cover and PV production card for Home Assistant",
   "license": "GPL-3.0-or-later",
   "type": "module",

package.json

@@ -86,7 +86,7 @@ export function gridSourceName(host: ChartHost, index: number, dir: 'import' | '
 export function batterySourceName(host: ChartHost, index: number, dir: 'charge' | 'discharge'): string
 {
     const ed = host._energyDefaults;
-    //Prefer the Energy dashboard's configured per-source name (#365); else the meter friendly name, then a generic.
+    //Prefer the Energy dashboard's configured per-source name; else the meter friendly name, then a generic.
     const configured = ed.batteryNames[index];
     if (configured) { return configured; }
     const id = (dir === 'charge' ? ed.batteryStatEnergyTos : ed.batteryStatEnergyFroms)[index];

src/charts/charts.ts

@@ -245,7 +245,7 @@ export function autoHideUi(config: HeliosConfig | undefined): boolean
 }
 
 
-//"Your real sky" weather effects. Default on (explicit false disables). The dev console is opt-in (default off).
+//"Your real sky" weather effects. Default on (explicit false disables).
 export function weatherEnabled(config: HeliosConfig | undefined): boolean
 {
     return config?.['weather-enabled'] !== false;

src/core/config/helios-config.ts

@@ -818,8 +818,8 @@ export const heliosCardStyles = css`
         background: radial-gradient(circle, rgba(30, 35, 42, 0.45), rgba(30, 35, 42, 0) 68%);
     }
     /*  Sized in cqw (share of the card's WIDTH, via ha-card's container-type: inline-size) for BOTH axes, so the
-        shadows stay round at any card shape. Percent height made them tall ovals on a narrow card (#332, tfriberg):
-        55% of a small width vs 70% of a tall height. left/top keep % for placement; the sweep is element-relative. */
+        shadows stay round at any card shape. Percent height made them tall ovals on a narrow card: 55% of a small
+        width vs 70% of a tall height. left/top keep % for placement; the sweep is element-relative. */
     .helios-wx-cloud.k1 { width: 55cqw; height: 55cqw; left: -30%; top: -10%; animation: helios-wx-sweep 22s linear infinite; }
     .helios-wx-cloud.k2 { width: 42cqw; height: 42cqw; left: -30%; top: 20%; animation: helios-wx-sweep 30s linear infinite; animation-delay: -8s; }
     .helios-wx-cloud.k3 { width: 66cqw; height: 66cqw; left: -45%; top: -20%; animation: helios-wx-sweep 40s linear infinite; animation-delay: -16s; }
@@ -833,7 +833,7 @@ export const heliosCardStyles = css`
             radial-gradient(35% 25% at 70% 78%, rgba(150, 180, 215, 0.14), transparent 70%);
     }
 
-    /*  Weather chips (temperature, then humidity): a centered row pinned along the BOTTOM of the scene, so they
+    /*  Corner chips (cost, temperature, humidity): a centered row pinned along the BOTTOM of the scene, so they
         read as secondary info and group with the home/grid/battery pill family rather than fighting the irradiance
         chip up top. Below the timeline's z-index (1000) so the timeline always wins on overlap. Each icon is tinted
         by --chip-color.  */
@@ -894,11 +894,11 @@ export const heliosCardStyles = css`
         display: inline-flex;
         align-items: center;
     }
-    /*  Clickable + active states, mirroring the scene chips: [role=button] re-enables events (the column is
+    /*  Clickable + active states, mirroring the scene chips: [role=button] re-enables events (the row is
         pointer-events:none), .is-chart-active raises the halo, .is-curve-on fills the pill with the metric colour.  */
     .helios-corner-chip[role="button"] { pointer-events: auto; cursor: pointer; }
-    /*  Day-curve open: the non-active weather chip becomes an inert, invisible placeholder. It still reserves its
-        slot width so the centered row does not shift the surviving chip when its sibling drops out.  */
+    /*  Day-curve open: each non-active corner chip becomes an inert, invisible placeholder. It still reserves its
+        slot width so the centered row does not shift the surviving chip when its siblings drop out.  */
     .helios-corner-chip.is-slot-hidden { visibility: hidden; pointer-events: none; }
     .helios-corner-chip::after
     {

src/css/helios-card-scene-css.ts

@@ -1,14 +1,9 @@
 //Live cost rate for the cost chip: the NET money flow right now, in the user's currency per hour.
-//
-//net rate = import cost - export revenue = importPrice x importPower - exportPrice x exportPower,
-//with power taken from the already-computed live grid slots and price per the HYBRID rule agreed for the feature:
-//  - a single configured price (one entity, or one static number) -> that price, measured, exact, no lag;
-//  - several prices (a multi-tariff grid, e.g. Tempo) -> resolved later from the recent stat_cost/stat_energy
-//    delta (the effective active price); until that lands the rate is left null so the chip hides rather than
-//    guessing the wrong tariff.
-//
-//Everything is absent unless the user configured cost in the Energy dashboard, matching Helios' rule: measured or
-//absent, never invented. Positive rate = you are spending; negative = you are earning (solar surplus sold).
+//net rate = import cost - export revenue = importPrice x importPower - exportPrice x exportPower.
+//Prices follow a hybrid rule: a single configured price (one entity or one static number) is used directly,
+//exact and lag-free; a multi-tariff grid (e.g. Tempo) is read from HA's own cost statistics instead, since
+//averaging tariffs would misprice the moment. Nothing is shown unless cost is configured in the Energy dashboard
+//(Helios' rule: measured or absent, never invented). Positive rate = spending, negative = earning (surplus sold).
 
 import { parseNumericState, pvNormalizeToWatts } from '../../core/format/format';
 import type { EnergyDefaults } from './energy-prefs';
@@ -102,8 +97,8 @@ function latestCostRate(host: CostHost): number | null
 
 
 //Resolve a single €/kWh price for one direction: exactly one price entity -> its live numeric state; else exactly
-//one static number -> that number; otherwise null (no price, or a multi-tariff set handled by the effective-price
-//path later). Never averages several tariffs: that would misprice the moment.
+//one static number -> that number; otherwise null (no price, or a multi-tariff set the cost-statistic path handles
+//instead). Never averages several tariffs: that would misprice the moment.
 function singlePrice(hass: CostHost['hass'], entities: string[], numbers: number[]): number | null
 {
     if (entities.length === 1)
@@ -119,7 +114,7 @@ function singlePrice(hass: CostHost['hass'], entities: string[], numbers: number
 
 //The single static price (currency/kWh) for one direction, or null when there is none or a multi-tariff set.
 //Used by the durable cost curve: with a constant price, cost = energy x price is exact across the WHOLE history
-//(no HA stat_cost backfill needed). Variable (entity) prices are handled separately, later.
+//(no HA stat_cost backfill needed). Variable (entity) prices are handled by the cost-statistic path instead.
 export function staticPrice(numbers: number[]): number | null
 {
     return numbers.length === 1 ? numbers[0] : null;
@@ -164,8 +159,8 @@ export function refreshCostLive(host: CostHost): void
     const importPrice = singlePrice(host.hass, d.gridImportPrices, d.gridImportPriceNumbers);
     const exportPrice = singlePrice(host.hass, d.gridExportPrices, d.gridExportPriceNumbers);
 
-    //No resolvable import price (0 or multi-tariff): leave the rate null for now (Inc. 2 fills multi-tariff from
-    //the effective price). Export-only pricing with no import price is not a real setup, so gate on import.
+    //No resolvable single import price (multi-tariff is served by the cost-statistic path above, not here): leave
+    //the rate null. Export-only pricing with no import price is not a real setup, so gate on import.
     if (importPrice === null)
     {
         if (host._costRate !== null) { host._costRate = null; }

src/data/sources/cost.ts

@@ -53,7 +53,7 @@ export interface EnergyDefaults
     gridName:               string;
     batteryName:            string;
     //Per-source battery names (the Energy dashboard `name` field, in source order; '' when unset). Drives the
-    //battery detail chart's per-bank labels so a multi-bank install reads its own names, not "Battery N" (#365).
+    //battery detail chart's per-bank labels so a multi-bank install reads its own names, not "Battery N".
     batteryNames:           string[];
     //Individual devices from the dashboard's per-device tracking (`device_consumption`), in dashboard order. NOT part
     //of the source flows above (they are sub-measurements of the home load), kept separately for the monitoring
@@ -386,9 +386,9 @@ export function parseEnergyPrefs(prefs: {
             //no cost is tracked (the cost chip then stays hidden). Import price/cost live on flow_from + top-level;
             //export compensation on flow_to (top-level entity_energy_price is the IMPORT price, never read as export).
             //Import flows: price (entity/number) + cost statistic. When no explicit `stat_cost` is set, Home
-            //Assistant AUTO-GENERATES one named `<stat_energy_from>_cost` as soon as a price is configured (verified
-            //on real HC/HP + Tempo installs). Deriving it gives an exact, per-tariff cost with zero extra config,
-            //so a multi-tariff grid (several priced flows) just works. The fetch is graceful if the id doesn't exist.
+            //Assistant auto-generates one named `<stat_energy_from>_cost` as soon as a price is configured.
+            //Deriving it gives an exact, per-tariff cost with zero extra config, so a multi-tariff grid (several
+            //priced flows) just works. The fetch is graceful if the id doesn't exist.
             for (const f of [src, ...asRecordArray(src['flow_from'])])
             {
                 const meter = pickFirstString(f['stat_energy_from']);
@@ -434,7 +434,7 @@ export function parseEnergyPrefs(prefs: {
         else if (type === 'battery')
         {
             const battName = pickFirstString(src['name']) ?? '';
-            //Per-source name, in battery-source order, for the detail chart's per-bank labels (#365).
+            //Per-source name, in battery-source order, for the detail chart's per-bank labels.
             out.batteryNames.push(battName);
             if (!out.batteryName)
             {

src/data/sources/energy-prefs.ts

@@ -1010,28 +1010,28 @@ export class HeliosCard extends LitElement
         if (!showTemperature(this.config) || !isFinite(this._temperature)) { return nothing; }
         //When a day curve is up, only the active chip is visible; the other stays in the DOM as an invisible
         //placeholder so the visible chip keeps its slot (the centered row must not shift when its sibling drops).
-        const dimmed = this._dayCurveOpen && this._chartTarget !== 'temperature';
-        return this._cornerChip('temperature', `${this._temperature.toFixed(1)} °C`, dimmed);
+        const hidden = this._dayCurveOpen && this._chartTarget !== 'temperature';
+        return this._cornerChip('temperature', `${this._temperature.toFixed(1)} °C`, hidden);
     }
     private _renderHumidityChip(): TemplateResult | typeof nothing
     {
         if (!showHumidity(this.config) || !isFinite(this._humidity)) { return nothing; }
-        const dimmed = this._dayCurveOpen && this._chartTarget !== 'humidity';
-        return this._cornerChip('humidity', `${Math.round(this._humidity)} %`, dimmed);
+        const hidden = this._dayCurveOpen && this._chartTarget !== 'humidity';
+        return this._cornerChip('humidity', `${Math.round(this._humidity)} %`, hidden);
     }
-    private _cornerChip(slot: 'temperature' | 'humidity' | 'cost', text: string, dimmed: boolean): TemplateResult
+    private _cornerChip(slot: 'temperature' | 'humidity' | 'cost', text: string, hidden: boolean): TemplateResult
     {
         const color   = chipSlotColor(this, this.config, slot);
         const icon    = chipSlotIcon(this.config, slot);
         //Same re-targeting gesture as the scene chips: one tap points the chart + around-house curve at this
         //metric, a second tap on the active chip toggles its day curve (onChartTargetClick).
         const active  = this._chartTarget === slot;
         const curveOn = active && this._dayCurveOpen;
-        //A dimmed chip carries is-slot-hidden (visibility:hidden): it reserves its width but is automatically
+        //A hidden chip carries is-slot-hidden (visibility:hidden): it reserves its width but is automatically
         //inert, unfocusable and out of the a11y tree, so role/tabindex/click can stay static.
         return html`
             <div
-                class="helios-corner-chip ${active ? 'is-chart-active' : ''} ${curveOn ? 'is-curve-on' : ''} ${dimmed ? 'is-slot-hidden' : ''}"
+                class="helios-corner-chip ${active ? 'is-chart-active' : ''} ${curveOn ? 'is-curve-on' : ''} ${hidden ? 'is-slot-hidden' : ''}"
                 style=${`--chip-color:${color}`}
                 role="button"
                 tabindex="0"
@@ -1043,22 +1043,22 @@ export class HeliosCard extends LitElement
             </div>`;
     }
 
-    //Cost chip (2026.9.0): the live NET money rate in the user's currency per hour. Fixed, user-configurable colour
+    //Cost chip: the live NET money rate in the user's currency per hour. Fixed, user-configurable colour
     //+ icon like every other chip (no sign-driven colour); spend vs earn is carried by the value's sign (a negative
     //rate means you are earning). Tap it like any chip to bring up its cost curve. Hidden when turned off or when no
     //cost is configured (no resolvable rate).
     private _renderCostChip(): TemplateResult | typeof nothing
     {
         if (!showCost(this.config) || this._costRate === null) { return nothing; }
-        const dimmed = this._dayCurveOpen && this._chartTarget !== 'cost';
+        const hidden = this._dayCurveOpen && this._chartTarget !== 'cost';
         const val = this._costRate
             .toLocaleString(undefined, { minimumFractionDigits: 2, maximumFractionDigits: 2 });
-        return this._cornerChip('cost', `${val} ${this._currency}/h`, dimmed);
+        return this._cornerChip('cost', `${val} ${this._currency}/h`, hidden);
     }
 
     //Push the resolved weather onto the host as --wx-* vars (scene grade + overlay strengths) and drive the
-    //rain/snow/storm controllers. Source is the live/scrub weather, or the dev-console override when set. The sun
-    //glow is anchored on the real sun position and gated on daylight.
+    //rain/snow/storm controllers. Source is the resolved live/scrub weather (any local sensor overrides are
+    //already folded in upstream). The sun glow is anchored on the real sun position and gated on daylight.
     private _applyWeather(): void
     {
         this.toggleAttribute('data-wx-on', this._wxOn);
@@ -1094,8 +1094,8 @@ export class HeliosCard extends LitElement
         //"No UI" mode: reflect the faded state onto the host so the CSS fades the timeline + controls.
         this.toggleAttribute('data-ui-hidden', this._uiHidden);
 
-        //"Your real sky": recompute the weather layers whenever the resolved weather, the master switch, the sun
-        //(glow anchor + day/night) or the dev-console override changes.
+        //"Your real sky": recompute the weather layers whenever the resolved weather, the master switch or the sun
+        //(glow anchor + day/night) changes.
         if (_changedProperties.has('_cloudCover') || _changedProperties.has('_precip')
             || _changedProperties.has('_snowfall') || _changedProperties.has('_weatherCode')
             || _changedProperties.has('_wxOn') || _changedProperties.has('_sunScene')

src/helios-card.ts

@@ -213,7 +213,7 @@ export class SceneHudController
         //Home anchor: the hollow ring stays while a chip that DOCKS A LEADER on it is visible (production, grid,
         //battery, device groups). The sun/irradiance chip sits by the sun disc with no leader to the home, so it
         //does NOT hold the ring: a sun-position card (home hidden, only the sun chip) drops the ring and leaves
-        //just the sun + location, e.g. a shutter/climate page keyed on the sun (#310). Config-driven so it stays
+        //just the sun + location, e.g. a shutter/climate page keyed on the sun. Config-driven so it stays
         //stable across scrubbing.
         const anyHomeLeaderChipVisible = showChipProduction || showChipGrid || showChipBattery
             || activeGroups(this.host.config, this.host._energyDefaults).some(g => groupChipVisible(cfg, g) && keeps(groupTarget(g)));