glenn schrooyenandClaude Opus 5
fdaf3fb54f
checks / unit (pull_request) Successful in 6m17s
The Configuration tab can only render types and ranges. `validate.py`'s most
useful refusals are CROSS-FIELD - two inverters naming one `setpoint_entity`, a
`maintenance_charge_w` above `max_w`, a flat `setpoint_entity` left set beside a
declared roster - and the Supervisor's UI has no way to express a rule spanning
two keys. Today the operator meets those as exit 78 in a log, after saving and
restarting. This puts them on the screen beside the field they name, before
anything is written.
WHAT IT ADDS
app/configui.py the field model, built from `GET /addons/self/info`'s own
`schema` + `translations`. No option key, no label, no
rule of its own. UX-01's `Group · ` label prefix becomes a
real section heading, in whichever language resolved.
app/selfconfig.py the Supervisor conversation and the write gate.
app/config_page.py the page. Its longest function decides which HTML input a
type deserves; it contains no rule.
app/web.py five routes. Still the only file a reviewer has to read to
answer "does anything here reach the inverter".
THE FOUR THINGS THAT COULD HURT SOMEBODY, AND HOW EACH IS HELD
1. A blob the SHIPPED validator refuses is never written - not warned about,
not written. An invalid blob plus a restart is exit 78, and the panel is
gone with the add-on that serves it.
2. A blob that moved underneath is refused, not clobbered. Read hands out a
sha256 of the canonical blob, save hands it back, and the stored blob is
re-read IMMEDIATELY BEFORE the write. This is SAFETY-28's discipline
applied to configuration - "a blob reaches the Supervisor only if it was
derived from the blob stored right now" - with the honest weakening stated
in the decision record: a second writer is DETECTED, not made
inexpressible.
3. Every message is the validator's own, byte for byte. test_selfconfig.py
part 6 inserts ONE new rule into a COPY of validate.py, hashes every file
under app/ to show validate.py is the only one that differs, and serves the
real /config/validate route out of that copy in a subprocess. The new
sentence arrives, filed under the key it names.
4. Nothing on the surface commands an inverter or clears a latch. Saving does
not restart: applying costs a control interruption - the wind-down commands
0 W on every inverter - so that is a separate, confirmed button that says
so first.
MEASURED, NOT CITED (tools/supervisor_selfapi_probe.py, run against
Supervisor 2026.08.0's own code; it contacts nothing)
- the three self-paths are permitted, and `/addons/self/info` is admitted by
the `default` role too while `options` and `restart` rest on the bypass
ALONE. The probe's first draft claimed the role admitted none of the three
and went red.
- `/addons/self/options/validate` is NOT reachable from inside an add-on, so
the only validator this panel can call is ours - which is the one with the
cross-field rules.
- a POST that omits a key does not preserve it: the key reverts to
config.yaml's default. Hence whole-blob read-modify-write.
- the Configuration tab CAN be removed, and doing so drops 0-of-71 options
through and takes the add-on down. The card said it could not be; it stays
by decision, which is a better reason.
DOES NOT TOUCH config.yaml, main.py or any control path. UX-01 is a dependency,
not something this supersedes: its translations are where every label,
description and section heading on this page comes from, and the Configuration
tab is still the recovery surface. DECISIONS/UX-02-two-config-surfaces.md
records which surface is authoritative (neither: the stored blob is) and what
the second surface costs.
Also corrects a stale "70 options" in three prose spots to the 71 the probe
counts - config.yaml grew a key in SAFETY-42 and the sentences did not follow.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BwRLw7eKYj2byVdwB6kbjU
---
⚠️ REBASED ONTO release/1.0 @ 3368231, AND HISTORY DELIBERATELY FLATTENED.
The original branch carried `653874d` - an ORPHANED first attempt at PKG-07
whose commit message justified the version bump with a claim that was FALSE
(that `slew_w: 0` used to mean "no limit"; the schema was `int(50,5000)` from
the repo's first commit, so 0 was never legal). That commit's CONTENT was
superseded when release/1.0 was merged in, and the merge resolved correctly -
one 0.8.0 section, no fabricated text. But the retracted claim would have
entered release/1.0's history as a commit message with no retraction attached
to it, where PKG-07's own merged commit is the thing that retracts it.
So the branch is replayed as a single commit on top of the corrected PKG-07
rather than merged with the bad one trailing behind. The tree is byte-identical
to the reviewed branch tip; only the ancestry changed.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BwRLw7eKYj2byVdwB6kbjU
563 lines
23 KiB
Python
563 lines
23 KiB
Python
"""UX-02: the configuration page itself - markup, style and the form's script.
|
|
|
|
⚠️ WHY THIS IS ITS OWN FILE. `web.py` is the ROUTES: three status handlers and,
|
|
since this card, five configuration ones. The page is ~500 lines of HTML, CSS
|
|
and JavaScript, and inlining it there would bury the routing - which is the
|
|
half a reviewer has to check for "does anything here command an inverter".
|
|
|
|
⚠️ AND WHAT IS NOT IN THIS FILE, WHICH IS THE POINT OF THE CARD. There is no
|
|
option key, no label, no unit, no range, no default and NO RULE in the script
|
|
below. It renders a model the server built out of `GET /addons/self/info`
|
|
(app/configui.py) and it renders refusals the server got out of
|
|
`validate_startup_config()` (app/selfconfig.py). Its longest function is the one
|
|
that decides which HTML input a `type` deserves.
|
|
|
|
That is deliberate and it is checkable: test_selfconfig.py part 5 greps this
|
|
file for the option keys and for phrases out of validate.py's refusals and
|
|
asserts it contains none of them, and part 6 adds a NEW rule to a copy of
|
|
validate.py and watches it appear on the page with this file untouched.
|
|
|
|
⚠️ EVERY URL IS RELATIVE. Ingress serves the add-on under a generated path
|
|
prefix (`/api/hassio_ingress/<token>/`), so an absolute `/config/model` 404s in
|
|
the field while working perfectly on a laptop. web.py's own header has said so
|
|
since the status page shipped; this file has five more chances to get it wrong.
|
|
|
|
⚠️ AND IT IS BUILT FOR A PHONE FIRST. This is the screen someone stands in
|
|
front of the inverter with: one column, big touch targets, sections that start
|
|
collapsed so 71 options do not arrive as one wall, and the refusal block pinned
|
|
where it cannot be scrolled past.
|
|
"""
|
|
|
|
CONFIG_PAGE = """<!doctype html>
|
|
<html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>GoodWe - Configuration</title>
|
|
<style>
|
|
:root{--bg:#f5f6f8;--card:#fff;--ink:#1c1e21;--muted:#6b7280;--line:#e5e7eb;
|
|
--ok:#137333;--warn:#b25e02;--bad:#c5221f;--accent:#1a73e8;
|
|
--badtint:rgba(197,34,31,.10);--warntint:rgba(178,94,2,.10);
|
|
--oktint:rgba(19,115,51,.10)}
|
|
@media(prefers-color-scheme:dark){:root{--bg:#111317;--card:#1b1e24;--ink:#e8eaed;
|
|
--muted:#9aa0a6;--line:#2c3038;--ok:#81c995;--warn:#fdd663;--bad:#f28b82;
|
|
--accent:#8ab4f8;--badtint:rgba(242,139,130,.14);
|
|
--warntint:rgba(253,214,99,.14);--oktint:rgba(129,201,149,.14)}}
|
|
*{box-sizing:border-box}
|
|
body{margin:0;padding:0 0 96px;background:var(--bg);color:var(--ink);
|
|
font:15px/1.5 system-ui,-apple-system,Segoe UI,Roboto,sans-serif}
|
|
.wrap{max-width:760px;margin:0 auto;padding:14px}
|
|
h1{font-size:18px;margin:0 0 2px}
|
|
a{color:var(--accent)}
|
|
.sub{color:var(--muted);font-size:13px;margin:0 0 12px}
|
|
.card{background:var(--card);border:1px solid var(--line);border-radius:10px;
|
|
padding:14px;margin-bottom:12px}
|
|
.note{border-left:4px solid var(--warn);background:var(--warntint);
|
|
border-radius:8px;padding:11px 13px;margin-bottom:12px;font-size:14px}
|
|
.note.bad{border-left-color:var(--bad);background:var(--badtint)}
|
|
.note.ok{border-left-color:var(--ok);background:var(--oktint)}
|
|
.note b{display:block;margin-bottom:3px}
|
|
details.grp{background:var(--card);border:1px solid var(--line);
|
|
border-radius:10px;margin-bottom:10px;overflow:hidden}
|
|
details.grp>summary{cursor:pointer;padding:14px;font-weight:600;
|
|
list-style:none;display:flex;justify-content:space-between;gap:10px;
|
|
align-items:center}
|
|
details.grp>summary::-webkit-details-marker{display:none}
|
|
details.grp>summary::after{content:"\\25be";color:var(--muted);font-weight:400}
|
|
details.grp[open]>summary::after{content:"\\25b4"}
|
|
details.grp[open]>summary{border-bottom:1px solid var(--line)}
|
|
.gbody{padding:4px 14px 14px}
|
|
.pill{font-size:12px;font-weight:600;border-radius:999px;padding:2px 9px;
|
|
background:var(--badtint);color:var(--bad)}
|
|
.pill.q{background:var(--warntint);color:var(--warn)}
|
|
.f{padding:13px 0;border-bottom:1px solid var(--line)}
|
|
.f:last-child{border-bottom:0}
|
|
.f>label{display:block;font-weight:600;margin-bottom:2px}
|
|
.k{font:12px/1.4 ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--muted)}
|
|
.row{display:flex;gap:8px;align-items:center;margin:6px 0 0}
|
|
.row input[type=text],.row input[type=number],.row select{flex:1 1 auto;
|
|
min-width:0;font:inherit;padding:10px;border-radius:8px;
|
|
border:1px solid var(--line);background:var(--bg);color:var(--ink)}
|
|
.row .unit{color:var(--muted);font-size:13px;white-space:nowrap}
|
|
.rng{color:var(--muted);font-size:12px;margin-top:4px}
|
|
.help{color:var(--muted);font-size:13px;margin-top:6px;cursor:pointer;
|
|
max-height:3.1em;overflow:hidden;position:relative}
|
|
.help.open{max-height:none}
|
|
.help::after{content:" more";color:var(--accent)}
|
|
.help.open::after{content:" less";color:var(--accent)}
|
|
.prob{margin-top:8px;border-left:4px solid var(--bad);background:var(--badtint);
|
|
border-radius:6px;padding:9px 11px;font-size:13.5px}
|
|
.prob+.prob{margin-top:6px}
|
|
.sw{display:flex;align-items:center;gap:10px;margin-top:6px}
|
|
.sw input{width:20px;height:20px}
|
|
.entry{border:1px solid var(--line);border-radius:9px;padding:10px 12px;
|
|
margin:10px 0;background:var(--bg)}
|
|
.entry h4{margin:0 0 2px;font-size:14px}
|
|
button{font:inherit;padding:10px 14px;border-radius:8px;
|
|
border:1px solid var(--line);background:var(--card);color:var(--ink);
|
|
cursor:pointer}
|
|
button.primary{background:var(--accent);border-color:var(--accent);color:#fff}
|
|
button.danger{background:var(--bad);border-color:var(--bad);color:#fff}
|
|
button[disabled]{opacity:.5;cursor:not-allowed}
|
|
button.small{padding:6px 10px;font-size:13px}
|
|
.bar{position:fixed;left:0;right:0;bottom:0;background:var(--card);
|
|
border-top:1px solid var(--line);padding:10px 14px;z-index:5}
|
|
.bar .in{max-width:760px;margin:0 auto;display:flex;gap:10px;
|
|
align-items:center;flex-wrap:wrap}
|
|
.bar .msg{flex:1 1 200px;min-width:0;font-size:13px;color:var(--muted)}
|
|
dialog{border:1px solid var(--line);border-radius:12px;background:var(--card);
|
|
color:var(--ink);max-width:520px;width:92%;padding:18px}
|
|
dialog::backdrop{background:rgba(0,0,0,.5)}
|
|
.diff{font:12.5px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace;
|
|
white-space:pre-wrap;word-break:break-word;margin-top:6px}
|
|
</style></head><body>
|
|
<div class="wrap">
|
|
<h1>GoodWe - Configuration</h1>
|
|
<p class="sub"><a href="./">← Status and controls</a></p>
|
|
|
|
<div class="note" id="authority">
|
|
<b>This page and the Supervisor's Configuration tab edit the same settings.</b>
|
|
Both write one options blob. This page is the one that can tell you a
|
|
setting is wrong <i>before</i> you save it; the Configuration tab cannot,
|
|
because it only knows types and ranges. If the add-on is not running, the
|
|
Configuration tab is the only one of the two that still exists - that is
|
|
what it is for.
|
|
</div>
|
|
|
|
<div class="note" id="restartcost">
|
|
<b>Saving does not restart anything, and does not take effect on its own.</b>
|
|
Stored settings are applied when the add-on next starts. Restarting to
|
|
apply them costs a short loss of control: the add-on commands
|
|
<b>0 W on every inverter</b> as it shuts down, and the battery does nothing
|
|
until it is back up. That is a separate button, below, with its own
|
|
confirmation.
|
|
</div>
|
|
|
|
<div id="banner"></div>
|
|
<div id="staleness"></div>
|
|
<div id="form"></div>
|
|
</div>
|
|
|
|
<div class="bar"><div class="in">
|
|
<button class="primary" id="save" disabled>Save settings</button>
|
|
<button id="restart" disabled>Restart to apply</button>
|
|
<button id="reload">Discard edits</button>
|
|
<span class="msg" id="msg">loading…</span>
|
|
</div></div>
|
|
|
|
<dialog id="confirm">
|
|
<h3 style="margin-top:0">Restart the add-on?</h3>
|
|
<p>The add-on will command <b>0 W on every inverter</b>, stop, and start
|
|
again with the stored settings. Control of the battery is lost for as long as
|
|
that takes. Nothing else about the inverter is changed, and no latched
|
|
failsafe is cleared.</p>
|
|
<div style="display:flex;gap:10px;justify-content:flex-end">
|
|
<button id="cancel">Cancel</button>
|
|
<button class="danger" id="go">Yes, restart now</button>
|
|
</div>
|
|
</dialog>
|
|
|
|
<script>
|
|
"use strict";
|
|
var MODEL = null; // groups/fields, from the server
|
|
var STORED = null; // the options blob the server last read
|
|
var FP = ""; // its fingerprint - the compare-and-swap token
|
|
var VALS = {}; // what is on screen right now
|
|
var timer = null;
|
|
|
|
function el(tag, cls, text){
|
|
var e = document.createElement(tag);
|
|
if(cls) e.className = cls;
|
|
if(text !== undefined && text !== null) e.textContent = text;
|
|
return e;
|
|
}
|
|
function msg(text, kind){
|
|
var m = document.getElementById('msg');
|
|
m.textContent = text;
|
|
m.style.color = kind === 'bad' ? 'var(--bad)'
|
|
: kind === 'ok' ? 'var(--ok)' : 'var(--muted)';
|
|
}
|
|
function note(host, kind, title, body){
|
|
var d = el('div', 'note ' + (kind || ''));
|
|
if(title) d.appendChild(el('b', null, title));
|
|
if(body) d.appendChild(document.createTextNode(body));
|
|
host.appendChild(d);
|
|
return d;
|
|
}
|
|
|
|
// --- the value of one input, by the type the SERVER gave the field ---------
|
|
// The only "knowledge" in this script: which HTML control a Supervisor type
|
|
// deserves, and how to read it back. No key names, no bounds, no rules.
|
|
function readInput(input, type){
|
|
if(type === 'boolean') return input.checked;
|
|
if(type === 'integer' || type === 'float'){
|
|
if(input.value === '') return '';
|
|
var n = Number(input.value);
|
|
return isNaN(n) ? input.value : n;
|
|
}
|
|
return input.value;
|
|
}
|
|
|
|
function makeInput(field, value, onchange){
|
|
var row = el('div', 'row');
|
|
var input;
|
|
if(field.type === 'boolean'){
|
|
row.className = 'sw';
|
|
input = el('input');
|
|
input.type = 'checkbox';
|
|
input.checked = !!value;
|
|
var lab = el('span', 'k', field.key);
|
|
row.appendChild(input); row.appendChild(lab);
|
|
} else if(field.type === 'select'){
|
|
input = el('select');
|
|
(field.options || []).forEach(function(o){
|
|
var opt = el('option', null, o); opt.value = o;
|
|
if(String(value) === o) opt.selected = true;
|
|
input.appendChild(opt);
|
|
});
|
|
row.appendChild(input);
|
|
} else {
|
|
input = el('input');
|
|
if(field.type === 'integer' || field.type === 'float'){
|
|
input.type = 'number';
|
|
input.inputMode = field.type === 'integer' ? 'numeric' : 'decimal';
|
|
input.step = field.type === 'integer' ? '1' : 'any';
|
|
if(field.min !== undefined) input.min = field.min;
|
|
if(field.max !== undefined) input.max = field.max;
|
|
} else {
|
|
input.type = 'text';
|
|
input.autocapitalize = 'none';
|
|
input.spellcheck = false;
|
|
}
|
|
input.value = (value === undefined || value === null) ? '' : value;
|
|
row.appendChild(input);
|
|
if(field.unit) row.appendChild(el('span', 'unit', field.unit));
|
|
}
|
|
input.addEventListener('input', onchange);
|
|
input.addEventListener('change', onchange);
|
|
return {row: row, input: input};
|
|
}
|
|
|
|
function helpBlock(field){
|
|
if(!field.help) return null;
|
|
var h = el('div', 'help', field.help);
|
|
h.title = field.help;
|
|
h.addEventListener('click', function(){ h.classList.toggle('open'); });
|
|
return h;
|
|
}
|
|
|
|
function rangeHint(field){
|
|
var bits = [];
|
|
if(field.min !== undefined || field.max !== undefined){
|
|
bits.push('accepted: ' + (field.min !== undefined ? field.min : '-')
|
|
+ ' to ' + (field.max !== undefined ? field.max : '-')
|
|
+ (field.unit ? ' ' + field.unit : ''));
|
|
}
|
|
bits.push(field.key);
|
|
return el('div', 'rng', bits.join(' \\u00b7 '));
|
|
}
|
|
|
|
// --- a list of scalars (`- str` in the schema) -----------------------------
|
|
function scalarList(field, value){
|
|
var box = el('div');
|
|
var items = Array.isArray(value) ? value.slice() : [];
|
|
function draw(){
|
|
box.textContent = '';
|
|
items.forEach(function(v, i){
|
|
var row = el('div', 'row');
|
|
var input = el('input'); input.type = 'text'; input.value = v;
|
|
input.autocapitalize = 'none'; input.spellcheck = false;
|
|
input.addEventListener('input', function(){
|
|
items[i] = input.value; VALS[field.key] = items.slice(); queue();
|
|
});
|
|
var rm = el('button', 'small', 'Remove');
|
|
rm.addEventListener('click', function(){
|
|
items.splice(i, 1); VALS[field.key] = items.slice(); draw(); queue();
|
|
});
|
|
row.appendChild(input); row.appendChild(rm);
|
|
box.appendChild(row);
|
|
});
|
|
var add = el('button', 'small', 'Add');
|
|
add.addEventListener('click', function(){
|
|
items.push(''); VALS[field.key] = items.slice(); draw(); queue();
|
|
});
|
|
box.appendChild(add);
|
|
}
|
|
draw();
|
|
return box;
|
|
}
|
|
|
|
// --- a list of objects: the roster editor ----------------------------------
|
|
function objectList(field, value){
|
|
var box = el('div');
|
|
var entries = Array.isArray(value) ? JSON.parse(JSON.stringify(value)) : [];
|
|
function push(){ VALS[field.key] = JSON.parse(JSON.stringify(entries)); }
|
|
function draw(){
|
|
box.textContent = '';
|
|
if(!entries.length){
|
|
var e = el('div', 'rng',
|
|
'No entries. With none, the settings above describe the one inverter.');
|
|
box.appendChild(e);
|
|
}
|
|
entries.forEach(function(entry, i){
|
|
var card = el('div', 'entry');
|
|
card.appendChild(el('h4', null, 'Entry ' + (i + 1)
|
|
+ (entry && entry.name ? ' \\u2014 ' + entry.name : '')));
|
|
(field.fields || []).forEach(function(sub){
|
|
var f = el('div', 'f');
|
|
// The label is the translation's own, verbatim - UX-01 already says
|
|
// "(optional)" in the ones that are, and adding a second one here
|
|
// would be this panel putting words next to a field.
|
|
f.appendChild(el('label', null, sub.label));
|
|
var made = makeInput(sub, entry ? entry[sub.key] : undefined,
|
|
function(){
|
|
entries[i][sub.key] = readInput(made.input, sub.type);
|
|
push(); queue();
|
|
});
|
|
f.appendChild(made.row);
|
|
f.appendChild(rangeHint(sub));
|
|
var h = helpBlock(sub); if(h) f.appendChild(h);
|
|
card.appendChild(f);
|
|
});
|
|
var rm = el('button', 'small danger', 'Remove this inverter');
|
|
rm.addEventListener('click', function(){
|
|
entries.splice(i, 1); push(); draw(); queue();
|
|
});
|
|
card.appendChild(rm);
|
|
box.appendChild(card);
|
|
});
|
|
var add = el('button', 'small', 'Add an inverter');
|
|
add.addEventListener('click', function(){
|
|
var fresh = {};
|
|
(field.fields || []).forEach(function(sub){
|
|
fresh[sub.key] = sub.type === 'boolean' ? false
|
|
: (sub.type === 'integer' || sub.type === 'float') ? ''
|
|
: '';
|
|
});
|
|
entries.push(fresh); push(); draw(); queue();
|
|
});
|
|
box.appendChild(add);
|
|
}
|
|
draw();
|
|
return box;
|
|
}
|
|
|
|
// --- rendering the whole form ---------------------------------------------
|
|
var FIELD_NODES = {};
|
|
|
|
function render(){
|
|
var host = document.getElementById('form');
|
|
host.textContent = '';
|
|
FIELD_NODES = {};
|
|
MODEL.groups.forEach(function(group){
|
|
var d = el('details', 'grp');
|
|
var s = el('summary');
|
|
s.appendChild(el('span', null, group.name || 'Not grouped'));
|
|
var pill = el('span', 'pill'); pill.style.display = 'none';
|
|
s.appendChild(pill);
|
|
d.appendChild(s);
|
|
var body = el('div', 'gbody');
|
|
group.fields.forEach(function(field){
|
|
var f = el('div', 'f');
|
|
f.appendChild(el('label', null, field.label));
|
|
if(field.type === 'schema'){
|
|
f.appendChild(objectList(field, VALS[field.key]));
|
|
} else if(field.multiple){
|
|
f.appendChild(scalarList(field, VALS[field.key]));
|
|
} else {
|
|
var made = makeInput(field, VALS[field.key], function(){
|
|
VALS[field.key] = readInput(made.input, field.type); queue();
|
|
});
|
|
f.appendChild(made.row);
|
|
}
|
|
if(field.type !== 'schema') f.appendChild(rangeHint(field));
|
|
var h = helpBlock(field); if(h) f.appendChild(h);
|
|
var probs = el('div'); f.appendChild(probs);
|
|
FIELD_NODES[field.key] = {probs: probs, group: d, pill: pill};
|
|
body.appendChild(f);
|
|
});
|
|
d.appendChild(body);
|
|
host.appendChild(d);
|
|
});
|
|
}
|
|
|
|
// --- refusals: printed exactly as the validator wrote them -----------------
|
|
function showProblems(payload){
|
|
Object.keys(FIELD_NODES).forEach(function(k){
|
|
FIELD_NODES[k].probs.textContent = '';
|
|
});
|
|
document.querySelectorAll('.pill').forEach(function(p){
|
|
p.style.display = 'none'; p.textContent = '';
|
|
});
|
|
var banner = document.getElementById('banner');
|
|
banner.textContent = '';
|
|
var counts = new Map();
|
|
Object.keys(payload.by_key || {}).forEach(function(key){
|
|
var node = FIELD_NODES[key];
|
|
payload.by_key[key].forEach(function(text){
|
|
var box = el('div', 'prob', text);
|
|
if(node) node.probs.appendChild(box); else banner.appendChild(box);
|
|
});
|
|
if(node){
|
|
counts.set(node.pill, (counts.get(node.pill) || 0)
|
|
+ payload.by_key[key].length);
|
|
node.group.open = true;
|
|
}
|
|
});
|
|
counts.forEach(function(n, pill){
|
|
pill.textContent = n + (n === 1 ? ' problem' : ' problems');
|
|
pill.style.display = '';
|
|
});
|
|
(payload.unanchored || []).forEach(function(text){
|
|
banner.appendChild(el('div', 'prob', text));
|
|
});
|
|
var total = (payload.problems || []).length;
|
|
var save = document.getElementById('save');
|
|
save.disabled = total > 0;
|
|
if(total){
|
|
note(banner, 'bad', 'This configuration would not start.',
|
|
'The add-on refuses to run on it and would stop with exit 78. '
|
|
+ 'Saving is blocked until these are fixed; nothing has been written. '
|
|
+ 'Each message below is the add-on\\u2019s own words, from the same '
|
|
+ 'check that runs at startup.');
|
|
banner.insertBefore(banner.lastChild, banner.firstChild);
|
|
msg(total + (total === 1 ? ' problem' : ' problems')
|
|
+ ' - saving is blocked', 'bad');
|
|
} else {
|
|
msg('this configuration would start', 'ok');
|
|
}
|
|
if(payload.device_note){
|
|
note(banner, '', 'Two range checks could not run.', payload.device_note);
|
|
}
|
|
}
|
|
|
|
// ⚠️ THE DEBOUNCE IS WHAT BOUNDS THE READS THIS PAGE MAKES OF HOME ASSISTANT.
|
|
// Each validation asks the setpoint device(s) for their own range, and those
|
|
// are real Core API reads on the same session the control loop uses. Because
|
|
// every keystroke RESETS the timer, sustained typing produces no requests at
|
|
// all and one lands 350 ms after the operator stops - which is the property
|
|
// that matters, not the number.
|
|
function queue(){
|
|
msg('checking\\u2026');
|
|
document.getElementById('save').disabled = true;
|
|
if(timer) clearTimeout(timer);
|
|
timer = setTimeout(validate, 350);
|
|
}
|
|
|
|
async function validate(){
|
|
try{
|
|
const r = await fetch('config/validate', {method: 'POST',
|
|
headers: {'Content-Type': 'application/json'},
|
|
body: JSON.stringify({options: VALS})});
|
|
showProblems(await r.json());
|
|
}catch(e){
|
|
msg('cannot reach the add-on: ' + e, 'bad');
|
|
}
|
|
}
|
|
|
|
function showStaleness(keys, stored){
|
|
var host = document.getElementById('staleness');
|
|
host.textContent = '';
|
|
if(!keys || !keys.length) return;
|
|
var d = note(host, '', 'Saved, but not running yet.',
|
|
'These settings are stored and differ from what this add-on is running '
|
|
+ 'right now. They take effect when it next starts:');
|
|
var pre = el('div', 'diff', keys.map(function(k){
|
|
return k + ': running ' + JSON.stringify(stored.running[k])
|
|
+ ' -> stored ' + JSON.stringify(stored.stored[k]);
|
|
}).join('\\n'));
|
|
d.appendChild(pre);
|
|
}
|
|
|
|
async function load(){
|
|
msg('loading\\u2026');
|
|
try{
|
|
const r = await fetch('config/model?lang='
|
|
+ encodeURIComponent((navigator.language || 'en')
|
|
.slice(0, 2)),
|
|
{cache: 'no-store'});
|
|
const m = await r.json();
|
|
MODEL = m; STORED = m.options; FP = m.fingerprint;
|
|
VALS = JSON.parse(JSON.stringify(m.options));
|
|
render();
|
|
showStaleness(m.running_differs, {running: m.running, stored: m.options});
|
|
document.getElementById('restart').disabled = false;
|
|
await validate();
|
|
}catch(e){
|
|
msg('cannot load the configuration: ' + e, 'bad');
|
|
}
|
|
}
|
|
|
|
async function save(){
|
|
msg('saving\\u2026');
|
|
document.getElementById('save').disabled = true;
|
|
var r, body;
|
|
try{
|
|
r = await fetch('config/save', {method: 'POST',
|
|
headers: {'Content-Type': 'application/json'},
|
|
body: JSON.stringify({options: VALS, fingerprint: FP})});
|
|
body = await r.json();
|
|
}catch(e){
|
|
msg('cannot reach the add-on: ' + e, 'bad');
|
|
document.getElementById('save').disabled = false;
|
|
return;
|
|
}
|
|
if(r.ok){
|
|
FP = body.fingerprint;
|
|
msg('saved - restart to apply', 'ok');
|
|
var host = document.getElementById('staleness');
|
|
host.textContent = '';
|
|
note(host, 'ok', 'Saved. Not applied yet.',
|
|
'The add-on is still running the settings it started with. Press '
|
|
+ '"Restart to apply" when you are ready to lose control of the '
|
|
+ 'battery for a few seconds.');
|
|
return;
|
|
}
|
|
if(body.kind === 'stale'){
|
|
var host2 = document.getElementById('staleness');
|
|
host2.textContent = '';
|
|
var d = note(host2, 'bad', 'Nothing was saved: these settings changed '
|
|
+ 'somewhere else while you were editing.',
|
|
'Somebody - most likely the Supervisor\\u2019s Configuration tab - '
|
|
+ 'wrote these settings after this page loaded. Your edits are still on '
|
|
+ 'screen and nothing has been overwritten. Read what changed, then '
|
|
+ 'press Save again if you still want your version.');
|
|
d.appendChild(el('div', 'diff', (body.changed || []).map(function(k){
|
|
return k + ': theirs ' + JSON.stringify(body.stored[k])
|
|
+ ' -> mine ' + JSON.stringify(VALS[k]);
|
|
}).join('\\n') || 'no key that this page also edits'));
|
|
FP = body.fingerprint;
|
|
msg('not saved - the stored settings had changed', 'bad');
|
|
document.getElementById('save').disabled = false;
|
|
return;
|
|
}
|
|
if(body.kind === 'invalid'){
|
|
showProblems(body);
|
|
msg('not saved - the configuration would not start', 'bad');
|
|
return;
|
|
}
|
|
msg('not saved: ' + (body.error || r.status), 'bad');
|
|
document.getElementById('save').disabled = false;
|
|
}
|
|
|
|
document.getElementById('save').addEventListener('click', save);
|
|
document.getElementById('reload').addEventListener('click', load);
|
|
document.getElementById('restart').addEventListener('click', function(){
|
|
document.getElementById('confirm').showModal();
|
|
});
|
|
document.getElementById('cancel').addEventListener('click', function(){
|
|
document.getElementById('confirm').close();
|
|
});
|
|
document.getElementById('go').addEventListener('click', async function(){
|
|
document.getElementById('confirm').close();
|
|
msg('restarting\\u2026');
|
|
try{
|
|
await fetch('config/restart', {method: 'POST',
|
|
headers: {'Content-Type': 'application/json'},
|
|
body: JSON.stringify({confirm: 'restart'})});
|
|
msg('restart requested - this page will stop answering for a moment');
|
|
}catch(e){
|
|
msg('restart requested - this page will stop answering for a moment');
|
|
}
|
|
});
|
|
load();
|
|
</script></body></html>
|
|
"""
|