`}get _alignPoint(){if(this._markup){if("draw"===this._tool&&this._path.length&&!this._contourClosed&&this._cursorPt)return this._cursorPt;if("split"===this._tool&&this._splitSel?.pts?.length&&this._cursorPt)return this._cursorPt;if(this._drag?.id.startsWith("rl_")&&this._drag.moved){const t=this._drag.id.slice(3),e=this._spaceModel().rooms.find(e=>e.id===t);return e?(()=>{const t=this._labelPos(e,this._space);return[t.x,t.y]})():null}return null}if("devices"===this._mode&&this._drag?.moved){const t=this._devices.find(t=>t.id===this._drag.id);return t?(()=>{const e=this._pos(t);return[e.x,e.y]})():null}if("decor"===this._mode){if(this._decorDraft)return this._decorDraft.b;if(this._decorMove){const t=this._decorList.find(t=>t.id===this._decorMove.id);if(!t)return null;const e=Ts,i=this._decorH;return"line"===t.kind?[t.x1*e,t.y1*i]:[t.x*e,t.y*i]}return null}return null}_alignCandidates(){const t=[],e=this._spaceModel();if(this._markup){if(this._drag?.id.startsWith("rl_")){const i=this._drag.id.slice(3);for(const s of e.rooms){if(!s.name||s.id===i)continue;const e=this._labelPos(s,this._space);t.push([e.x,e.y])}return t}for(const i of e.rooms){const e=we(i);if(e)for(const i of e)t.push(i)}if("draw"===this._tool)for(const e of this._path)t.push(e);if("split"===this._tool&&this._splitSel?.pts)for(const e of this._splitSel.pts)t.push(e);return t}if("devices"===this._mode){for(const e of this._devices){if(e.space!==this._space||e.id===this._drag?.id)continue;const i=this._pos(e);t.push([i.x,i.y])}return t}if("decor"===this._mode){const i=Ts,s=this._decorH,o=this._decorMove?.id;for(const e of this._decorList)e.id!==o&&("line"===e.kind?t.push([e.x1*i,e.y1*s],[e.x2*i,e.y2*s]):"text"===e.kind?t.push([e.x*i,e.y*s]):t.push([e.x*i,e.y*s],[(e.x+e.w)*i,e.y*s],[e.x*i,(e.y+e.h)*s],[(e.x+e.w)*i,(e.y+e.h)*s]));this._decorDraft&&t.push(this._decorDraft.a);for(const i of e.rooms){const e=we(i);if(e)for(const i of e)t.push(i)}return t}return t}_renderAlignGuides(){const t=this._alignPoint;if(!t)return j``;const e=this._drag?.id.startsWith("rl_")?.5*this._gridPitch:.05*this._gridPitch,i=function(t,e,i){let s=null,o=null;for(const n of e)if(!(Math.abs(n[0]-t[0])<1e-6&&Math.abs(n[1]-t[1])<1e-6)){if(Math.abs(n[0]-t[0])<=i){const e=Math.abs(n[1]-t[1]);e>1e-6&&(!s||e1e-6&&(!o||e
${i.map(e=>{const[i,n,r,a]="x"===e.axis?[e.at,e.from[1],e.at,t[1]+Math.sign(t[1]-e.from[1])*o]:[e.from[0],e.at,t[0]+Math.sign(t[0]-e.from[0])*o,e.at];return j``})}
- `}_roomCenter(t){if(t.poly){const e=t.poly.length;return[t.poly.reduce((t,e)=>t+e[0],0)/e,t.poly.reduce((t,e)=>t+e[1],0)/e]}return[t.x+t.w/2,t.y+.1*Math.min(t.w,t.h)]}_openingAmt(t){const e=t.contact?this.hass.states[t.contact]?.state:null;return function(t,e,i=!1){return null==e||"unavailable"===e||"unknown"===e?"door"===t?1:0:ke(e)!==!!i?1:0}(t.type,e,!!t.invert)}_renderOpenings(t){const e=this._openingsR;if(!e.length)return j``;const i=t.color;return j`${e.map(t=>{const e=t.rlen/2,s=this._openingAmt(t),o=s>0&&!!t.contact?"var(--hp-open)":i,n=t.flip_h?-1:1,r=t.flip_v?-1:1;let a;if("window"===t.type){const t=Math.PI/2*e;a=j`
+ `}_roomCenter(t){if(t.poly){const e=t.poly.length;return[t.poly.reduce((t,e)=>t+e[0],0)/e,t.poly.reduce((t,e)=>t+e[1],0)/e]}return[t.x+t.w/2,t.y+.1*Math.min(t.w,t.h)]}_openingAmt(t){const e=t.contact?this.hass.states[t.contact]?.state:null;return function(t,e,i=!1){return null==e||"unavailable"===e||"unknown"===e?"door"===t?1:0:$e(e)!==!!i?1:0}(t.type,e,!!t.invert)}_renderOpenings(t){const e=this._openingsR;if(!e.length)return j``;const i=t.color;return j`${e.map(t=>{const e=t.rlen/2,s=this._openingAmt(t),o=s>0&&!!t.contact?"var(--hp-open)":i,n=t.flip_h?-1:1,r=t.flip_v?-1:1;let a;if("window"===t.type){const t=Math.PI/2*e;a=j`
`}
`}get _alignPoint(){if(this._markup){if("draw"===this._tool&&this._path.length&&!this._contourClosed&&this._cursorPt)return this._cursorPt;if("split"===this._tool&&this._splitSel?.pts?.length&&this._cursorPt)return this._cursorPt;if(this._drag?.id.startsWith("rl_")&&this._drag.moved){const t=this._drag.id.slice(3),e=this._spaceModel().rooms.find(e=>e.id===t);return e?(()=>{const t=this._labelPos(e,this._space);return[t.x,t.y]})():null}return null}if("devices"===this._mode&&this._drag?.moved){const t=this._devices.find(t=>t.id===this._drag.id);return t?(()=>{const e=this._pos(t);return[e.x,e.y]})():null}if("decor"===this._mode){if(this._decorDraft)return this._decorDraft.b;if(this._decorMove){const t=this._decorList.find(t=>t.id===this._decorMove.id);if(!t)return null;const e=Ts,i=this._decorH;return"line"===t.kind?[t.x1*e,t.y1*i]:[t.x*e,t.y*i]}return null}return null}_alignCandidates(){const t=[],e=this._spaceModel();if(this._markup){if(this._drag?.id.startsWith("rl_")){const i=this._drag.id.slice(3);for(const s of e.rooms){if(!s.name||s.id===i)continue;const e=this._labelPos(s,this._space);t.push([e.x,e.y])}return t}for(const i of e.rooms){const e=we(i);if(e)for(const i of e)t.push(i)}if("draw"===this._tool)for(const e of this._path)t.push(e);if("split"===this._tool&&this._splitSel?.pts)for(const e of this._splitSel.pts)t.push(e);return t}if("devices"===this._mode){for(const e of this._devices){if(e.space!==this._space||e.id===this._drag?.id)continue;const i=this._pos(e);t.push([i.x,i.y])}return t}if("decor"===this._mode){const i=Ts,s=this._decorH,o=this._decorMove?.id;for(const e of this._decorList)e.id!==o&&("line"===e.kind?t.push([e.x1*i,e.y1*s],[e.x2*i,e.y2*s]):"text"===e.kind?t.push([e.x*i,e.y*s]):t.push([e.x*i,e.y*s],[(e.x+e.w)*i,e.y*s],[e.x*i,(e.y+e.h)*s],[(e.x+e.w)*i,(e.y+e.h)*s]));this._decorDraft&&t.push(this._decorDraft.a);for(const i of e.rooms){const e=we(i);if(e)for(const i of e)t.push(i)}return t}return t}_renderAlignGuides(){const t=this._alignPoint;if(!t)return j``;const e=this._drag?.id.startsWith("rl_")?.5*this._gridPitch:.05*this._gridPitch,i=function(t,e,i){let s=null,o=null;for(const n of e)if(!(Math.abs(n[0]-t[0])<1e-6&&Math.abs(n[1]-t[1])<1e-6)){if(Math.abs(n[0]-t[0])<=i){const e=Math.abs(n[1]-t[1]);e>1e-6&&(!s||e1e-6&&(!o||e
${i.map(e=>{const[i,n,r,a]="x"===e.axis?[e.at,e.from[1],e.at,t[1]+Math.sign(t[1]-e.from[1])*o]:[e.from[0],e.at,t[0]+Math.sign(t[0]-e.from[0])*o,e.at];return j``})}
- `}_roomCenter(t){if(t.poly){const e=t.poly.length;return[t.poly.reduce((t,e)=>t+e[0],0)/e,t.poly.reduce((t,e)=>t+e[1],0)/e]}return[t.x+t.w/2,t.y+.1*Math.min(t.w,t.h)]}_openingAmt(t){const e=t.contact?this.hass.states[t.contact]?.state:null;return function(t,e,i=!1){return null==e||"unavailable"===e||"unknown"===e?"door"===t?1:0:ke(e)!==!!i?1:0}(t.type,e,!!t.invert)}_renderOpenings(t){const e=this._openingsR;if(!e.length)return j``;const i=t.color;return j`${e.map(t=>{const e=t.rlen/2,s=this._openingAmt(t),o=s>0&&!!t.contact?"var(--hp-open)":i,n=t.flip_h?-1:1,r=t.flip_v?-1:1;let a;if("window"===t.type){const t=Math.PI/2*e;a=j`
+ `}_roomCenter(t){if(t.poly){const e=t.poly.length;return[t.poly.reduce((t,e)=>t+e[0],0)/e,t.poly.reduce((t,e)=>t+e[1],0)/e]}return[t.x+t.w/2,t.y+.1*Math.min(t.w,t.h)]}_openingAmt(t){const e=t.contact?this.hass.states[t.contact]?.state:null;return function(t,e,i=!1){return null==e||"unavailable"===e||"unknown"===e?"door"===t?1:0:$e(e)!==!!i?1:0}(t.type,e,!!t.invert)}_renderOpenings(t){const e=this._openingsR;if(!e.length)return j``;const i=t.color;return j`${e.map(t=>{const e=t.rlen/2,s=this._openingAmt(t),o=s>0&&!!t.contact?"var(--hp-open)":i,n=t.flip_h?-1:1,r=t.flip_v?-1:1;let a;if("window"===t.type){const t=Math.PI/2*e;a=j`
`}
- `}}As.properties={_hdrH:{state:!0},_tapConfirm:{state:!0},hass:{attribute:!1},_config:{state:!0},_space:{state:!0},_layout:{state:!0},_devices:{state:!0},_tip:{state:!0},_selId:{state:!0},_toast:{state:!0},_serverCfg:{state:!0},_mode:{state:!0},_tool:{state:!0},_path:{state:!0},_cursorPt:{state:!0},_mergeSel:{state:!0},_openingDialog:{state:!0},_openingInfo:{state:!0},_mergeDialog:{state:!0},_splitSel:{state:!0},_decorTool:{state:!0},_decorStyle:{state:!0},_decorDraft:{state:!0},_decorSel:{state:!0},_decorTextDialog:{state:!0},_kioskDialog:{state:!0},_vacFit:{state:!0},_kioskDots:{state:!0},_areaSel:{state:!0},_nameSel:{state:!0},_roomDialog:{state:!0},_roomEditId:{state:!0},_roomFill:{state:!0},_roomTempSrc:{state:!0},_roomHumSrc:{state:!0},_roomSrcOpen:{state:!0},_roomSrcFilter:{state:!0},_roomNameScale:{state:!0},_roomLabelScale:{state:!0},_spaceDialog:{state:!0},_infoCard:{state:!0},_rulesDialog:{state:!0},_settingsDialog:{state:!0},_importDialog:{state:!0},_markerDialog:{state:!0},_zoom:{state:!0},_view:{state:!0}},As.ZOOM_MAX=8,As.ZOOM_MIN=.4,As._touchSeen=!1,As._noHoverMq="undefined"!=typeof window&&"function"==typeof window.matchMedia&&window.matchMedia("(hover: none)").matches,As.styles=as,customElements.get("houseplan-card")||customElements.define("houseplan-card",As),window.customCards=window.customCards||[],window.customCards.find(t=>"houseplan-card"===t.type)||window.customCards.push({type:"houseplan-card",name:"House Plan Card",description:"Interactive house plan: spaces, rooms and devices with live states and drag layout."}),console.info("%c HOUSEPLAN-CARD %c v1.54.0 ","background:#3ea6ff;color:#04121f;font-weight:700","");
+ `}}As.properties={_hdrH:{state:!0},_tapConfirm:{state:!0},hass:{attribute:!1},_config:{state:!0},_space:{state:!0},_layout:{state:!0},_devices:{state:!0},_tip:{state:!0},_selId:{state:!0},_toast:{state:!0},_serverCfg:{state:!0},_mode:{state:!0},_tool:{state:!0},_path:{state:!0},_cursorPt:{state:!0},_mergeSel:{state:!0},_openingDialog:{state:!0},_openingInfo:{state:!0},_mergeDialog:{state:!0},_splitSel:{state:!0},_decorTool:{state:!0},_decorStyle:{state:!0},_decorDraft:{state:!0},_decorSel:{state:!0},_decorTextDialog:{state:!0},_kioskDialog:{state:!0},_vacFit:{state:!0},_kioskDots:{state:!0},_areaSel:{state:!0},_nameSel:{state:!0},_roomDialog:{state:!0},_roomEditId:{state:!0},_roomFill:{state:!0},_roomTempSrc:{state:!0},_roomHumSrc:{state:!0},_roomSrcOpen:{state:!0},_roomSrcFilter:{state:!0},_roomNameScale:{state:!0},_roomLabelScale:{state:!0},_spaceDialog:{state:!0},_infoCard:{state:!0},_rulesDialog:{state:!0},_settingsDialog:{state:!0},_importDialog:{state:!0},_markerDialog:{state:!0},_zoom:{state:!0},_view:{state:!0}},As.ZOOM_MAX=8,As.ZOOM_MIN=.4,As._touchSeen=!1,As._noHoverMq="undefined"!=typeof window&&"function"==typeof window.matchMedia&&window.matchMedia("(hover: none)").matches,As.styles=as,customElements.get("houseplan-card")||customElements.define("houseplan-card",As),window.customCards=window.customCards||[],window.customCards.find(t=>"houseplan-card"===t.type)||window.customCards.push({type:"houseplan-card",name:"House Plan Card",description:"Interactive house plan: spaces, rooms and devices with live states and drag layout."}),console.info("%c HOUSEPLAN-CARD %c v1.54.1 ","background:#3ea6ff;color:#04121f;font-weight:700","");
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index a1e1e77..6999455 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,37 @@
# Changelog
+## v1.54.1 — 2026-07-31
+
+Patch release: everything the adversarial audit of v1.54.0 found
+(HP-1540-01..06), each fix pinned by a regression test that fails on the
+old code.
+
+- **Fix: the first calibration of a freshly discovered vacuum silently did
+ nothing.** Until the device dialog was saved once, the robot had no config
+ marker — yet the «Живая позиция» section was fully interactive, and every
+ handler quietly bailed out while auto-calibration still announced success.
+ Any vacuum edit now materialises the marker itself, and the success toast
+ only appears after the matrix has verifiably landed in the config.
+- **Fix: a robot whose first map is `map_index: 0` lost its server-side
+ trail.** The backend picked the map id by truthiness and dropped the zero,
+ so the recorded run was stored under a key the card never looked up. Both
+ sides now share one explicit rule — the first value that exists wins, and
+ zero is a value.
+- **Fix: one robot on two floors recorded history for the last floor only.**
+ The recorder kept a single marker per source entity, so the second
+ placement silently evicted the first. Every marker fed by a source now
+ gets its own copy of the run.
+- **Fix: auto-calibration ignored plans drawn with rectangle rooms.** The
+ room matcher only accepted polygon outlines and then blamed the room
+ names. Legacy rectangles count like everywhere else in the card.
+- **Fix: overlapping recorder refreshes leaked state subscriptions.** Two
+ config saves racing each other could both subscribe and strand one
+ callback until restart; refreshes are serialised now and teardown wins
+ over any refresh still in flight.
+- The «no rooms» / «no match» toasts and docs/VACUUM.md no longer send you
+ to the three-point calibration that no longer exists — they point at
+ «Подогнать вручную», which does.
+
## v1.54.0 — 2026-07-31
### Live robot vacuums
diff --git a/docs/CHANGELOG.ru.md b/docs/CHANGELOG.ru.md
index 3d90d44..57ec7ac 100755
--- a/docs/CHANGELOG.ru.md
+++ b/docs/CHANGELOG.ru.md
@@ -6,6 +6,39 @@
> **Правило проекта:** оба файла пополняются в одном коммите с самим
> изменением — как и остальная документация (см. docs/STATUS.md).
+## v1.54.1 — 2026-07-31
+
+Патч-релиз: всё, что нашёл adversarial-аудит v1.54.0 (HP-1540-01..06),
+каждый фикс закреплён регрессией, падающей на старом коде.
+
+- **Исправлено: первая калибровка только что обнаруженного пылесоса молча
+ ничего не делала.** Пока диалог устройства ни разу не сохранён, у робота
+ нет маркера в конфиге — а раздел «Живая позиция» уже полностью
+ интерактивен: каждый обработчик тихо выходил, но автокалибровка всё равно
+ объявляла успех. Теперь любая правка пылесоса сама создаёт маркер, а тост
+ успеха появляется только после того, как матрица действительно легла в
+ конфиг.
+- **Исправлено: робот с первой картой `map_index: 0` терял серверный
+ след.** Бэкенд выбирал id карты по «истинности» и выбрасывал ноль, так
+ что записанная уборка хранилась под ключом, который карточка не искала.
+ Теперь обе стороны живут по одному явному правилу: побеждает первое
+ существующее значение, и ноль — значение.
+- **Исправлено: один робот на двух этажах писал историю только для
+ последнего этажа.** Рекордер держал по одному маркеру на источник, и
+ второе размещение молча вытесняло первое. Теперь каждый маркер источника
+ получает свою копию уборки.
+- **Исправлено: автокалибровка не видела планы из прямоугольных комнат.**
+ Сопоставление принимало только полигоны, а потом сваливало вину на имена
+ комнат. Старые прямоугольники считаются, как и во всей остальной
+ карточке.
+- **Исправлено: пересекающиеся обновления рекордера текли подписками.**
+ Два одновременных сохранения конфига могли подписаться оба и бросить один
+ callback до перезапуска; обновления теперь сериализованы, а teardown
+ выигрывает у любого ещё летящего обновления.
+- Тосты «нет комнат» / «имена не совпали» и docs/VACUUM.md больше не
+ отправляют к несуществующей калибровке по трём точкам — они ведут к
+ «Подогнать вручную», которая существует.
+
## v1.54.0 — 2026-07-31
### Роботы-пылесосы вживую
diff --git a/docs/STATUS.md b/docs/STATUS.md
index 83508c3..250af4d 100644
--- a/docs/STATUS.md
+++ b/docs/STATUS.md
@@ -15,7 +15,7 @@
| Item | State |
|---|---|
-| Version | **v1.54.0** everywhere (manifest, const.py, package.json, CARD_VERSION); deployed to the home instance |
+| Version | **v1.54.1** everywhere (manifest, const.py, package.json, CARD_VERSION); deployed to the home instance |
| Workflow | Since 2026-07-22: minor changes go to branch **`dev`** (build + smokes → deploy home → commit → push, NO release); releases are batched on the owner's command (merge dev→main, one tag, one release with a summary changelog, CI checked on dev beforehand) |
| GitHub | https://github.com/Matysh/houseplan-card — **`main` carries every published release, the latest tag is the current version above**; `dev` is where work lands and is merged into `main` at release time (so `dev` is normally equal to or ahead of `main`, never behind). Push via SSH key `ha_jb` (remote git@github.com:…); API releases via the fine-grained PAT in `~/.git-credentials` (Contents R/W, issued 2026-07-23) |
| CI | validate.yml (hacs + hassfest + frontend + backend) green; release.yml attaches the bundle on release publish |
@@ -24,7 +24,7 @@
| Localization | UI en/ru (src/i18n/*.json), everything user-visible localized incl. kiosk popover |
| Tests | Four layers: frontend unit (`npm test`, node:test over `test-build/`), pure backend (`pytest tests_backend`, runs anywhere), HA-harness backend (same folder, CI only — needs py3.13 + pytest-homeassistant-custom-component), and browser smokes (`demo/smoke_*.mjs`, headless chromium). **Counts are not written down here** — they went stale within two releases while the version line beside them was kept current, which reads as less coverage than exists (review R5-2). Run `npm run inventory` for the current numbers, or read them off the last CI run |
| Vacuums | Live robot vacuums shipped (docs/VACUUM.md): puck, server-side trails with display modes, fit-panel calibration. Verified on a live Dreame X50 Master |
-| Demo stand | **https://demo.houseplan.tech** — public, login `demo`/`demo`, resets to a pristine synthetic home every hour. **https://dev.houseplan.tech** — closed (basic auth), auto-deploys the `dev` branch every 10 min. Host: `ssh -i ~/.ssh/hp_stand hp@135.106.166.146`; layout, seeds and gotchas in the memory note `houseplan-demo-stand` |
+| Demo stand | **https://demo.houseplan.tech** — public, login `demo`/`demo`, resets to a pristine synthetic home every hour. **https://dev.houseplan.tech** — closed (basic auth), auto-deploys the `dev` branch every 10 min. Host: `ssh -i ~/.ssh/hp_stand hp@135.106.166.146`; layout, seeds and gotchas in the memory note `houseplan-demo-stand`. Since 2026-07-31 the stand covers most of the manual checklist: a scripted robot vacuum (`demo/stand/demo_robot` — Tasshack-shaped map sensor, serpentine run, pre-solved calibration, seeded server trail), Zigbee-style LQI template sensors, hand/auto-triggered leak+smoke alarms, an hvac_action climate marker and working script/scene/automation targets for tap-run. The stand-specific how-to-check guide is **docs/TESTING-DEMO.md** |
| Community | **Telegram chat: https://t.me/ha_houseplan** (created 2026-07-27) — the primary user-facing support channel; GitHub issues stay for bugs/features. Link it from any new release notes and posts |
| Product scope | docs/SCOPE.md (2026-07-22) is the feature guard rail — check before accepting any feature |
diff --git a/docs/TESTING-DEMO.md b/docs/TESTING-DEMO.md
new file mode 100644
index 0000000..e3392fc
--- /dev/null
+++ b/docs/TESTING-DEMO.md
@@ -0,0 +1,366 @@
+# Чек-лист ручного тестирования на публичном демо-стенде
+
+> **Стенд:** https://demo.houseplan.tech — вход **demo / demo** (админ).
+> Dev-версия: https://dev.houseplan.tech (basic auth `hp` / `houseplan-dev-2026`, дальше тот же demo/demo).
+>
+> **Стенд сбрасывается каждый час** к эталонному состоянию — это фича: ломайте
+> смело, удаляйте комнаты, заливайте планы, через час всё вернётся. Из этого же
+> следует: долгоживущие проверки («файл исчез через сутки», «пережило рестарт»)
+> на стенде не живут.
+>
+> Источник истины — [TESTING.md](TESTING.md): формулировки пунктов и их
+> `[auto:…]`-маркеры смотреть там. Здесь каждый пункт сокращён до сути и дополнен
+> строкой «Стенд: …» — где и как ткнуть именно на демо-стенде.
+>
+> **Демо-дом:** дашборд «House plan» (виды: План / Киоск / Схема), пространства
+> «1 этаж» (Гостиная, Кухня, Спальня, Кабинет, Прихожая) и «Двор». Ключевые
+> демо-устройства: робот-пылесос (Прихожая, симулятор `demo_robot`), датчик
+> протечки (Кухня, включается помощником `input_boolean.demo_leak`), датчик дыма
+> (Спальня, сам срабатывает каждые 10 минут на 30 с), «Тёплый пол» (Кабинет,
+> climate.heatpump, hvac_action=heating), 4 «Zigbee»-термометра + дверной датчик
+> с атрибутом `linkquality` (отличный/средний/слабый сигнал по комнатам),
+> маркер «Открыть шторы» (tap → запуск скрипта с подтверждением).
+
+## Вводные пункты (v1.43.x–v1.44.x)
+
+- Smoke-harness сам по себе — Стенд: не проверяется (это CI), только локально.
+- Шестерёнка «⚙ Room» на каждой карточке комнаты в редакторе плана — Стенд: открыть «Редактор плана», убедиться что у всех 5 комнат есть кнопка ⚙ фиксированного размера, открывает настройки комнаты.
+- Метрики 0.75 от имени комнаты — Стенд: включить метрики в настройках пространства (⚙ у «1 этаж») и посмотреть подпись под именем комнаты.
+- Тултип не появляется после touch — Стенд: открыть с планшета/телефона, потыкать комнаты и иконки — hover-тултипов быть не должно.
+- Флаг «источник света» у выключателя — Стенд: у «Decorative Lights» (Гостиная) в диалоге устройства включить «Это источник света» — при включении розетка светится в glow-заливке.
+- Карточка устройства: управляемые сущности сверху, ≥30 px, замки не переключаются — Стенд: тапнуть «Котёл» или медиаплеер; для замка — открыть карточку двери (бейдж замка на двери в Прихожей).
+- Инвариант замков на всех путях — Стенд: дверь в Прихожей: Unlock просит подтверждение, Lock — нет; иконка замка никогда не тогглится тапом.
+- Транзакционная миграция вложений — Стенд: прикрепить PDF к устройству, перепривязать маркер на другую сущность — файл открывается после перепривязки.
+- Планы и PDF в реальном браузере — Стенд: залить план в настройках пространства (любой PNG/SVG), DevTools → Network: `/api/houseplan/content/...` = 200 с `authSig`, тот же URL без authSig = 401.
+- Единая политика прав (may_write) — Стенд: не проверяется напрямую (нужен не-админ; на стенде один пользователь demo-админ) — покрыто tests_backend.
+- NaN/Infinity и лимиты openings — Стенд: не проверяется руками (нужен ручной WS-вызов) — tests_backend.
+- Захват указателя при drag, декор не утаскивается за границы — Стенд: «Редактор фона», нарисовать фигуру и попытаться утащить её далеко за план.
+- Скрытые термометры питают карточку комнаты — Стенд: скрыть «Термометр в гостиной» (галка «скрыть с плана») — температура в карточке Гостиной остаётся.
+- Тултип комнаты без «открыть area» — Стенд: навести на комнату с десктопа: имя + температура/сигнал, никакого «открыть».
+
+## Матрица окружений ★
+
+- Chrome/Edge desktop — Стенд: да, просто открыть.
+- Firefox desktop — Стенд: да, со своей машины.
+- Safari (macOS) — Стенд: да, при наличии Mac.
+- HA Companion Android (холодный старт!) — Стенд: да: добавить `https://demo.houseplan.tech` как сервер в приложении (demo/demo), убить приложение, открыть заново на дашборде House plan.
+- HA Companion iOS — Стенд: аналогично Android.
+- Планшет-киоск — Стенд: частично: открыть вид «Киоск» браузером планшета во весь экран; реальный настенный планшет — только на железе.
+- Телефон портрет ≤400 px — Стенд: да, или DevTools device mode.
+- Тёмная/светлая тема — Стенд: профиль demo → тема; проверить бейджи/диалоги/контраст.
+- RU/EN локали — Стенд: сменить язык в профиле пользователя demo; опцию `language:` карточки можно проверить, отредактировав вид дашборда.
+
+## Установка / обновление / удаление
+
+- Свежая установка через HACS — Стенд: не проверяется (интеграция ставится файлами, HACS нет) — локально.
+- `single_config_entry` — Стенд: Настройки → Устройства и службы → Добавить интеграцию → «House Plan» недоступна второй раз.
+- Обновление через HACS (`?v=` после рестарта) — Стенд: не проверяется (нет HACS; версию ресурса видно в DevTools: `houseplan-card.js?v=1.54.0`).
+- YAML-mode Lovelace / extra_module_url — Стенд: частично: стенд как раз грузит карточку через `extra_module_url` (см. configuration.yaml) — если дашборд открылся, механизм жив.
+- Удаление entry → ресурс исчезает, `.storage/houseplan.*` живёт — Стенд: можно (Настройки → Интеграции → House Plan → удалить), стенд сам восстановится при сбросе; переустановку файлами проверить нельзя.
+- Diagnostics download + REDACTED — Стенд: Настройки → Интеграции → House Plan → «Загрузить диагностику», убедиться что name/link/description/pdfs = `**REDACTED**`.
+
+## Режимы ★
+
+- Всегда открывается во View — Стенд: войти в редактор, перезагрузить страницу — карточка снова во View.
+- View: только pan/zoom/tap/long-press, иконки не таскаются — Стенд: попробовать утащить любую иконку в режиме просмотра — должен идти pan.
+- Шапка View: табы пространств, счётчик, zoom, табы редакторов, ⚙ — Стенд: глазами в шапке «1 этаж | Двор».
+- Plan: тулбар разметки, иконки скрыты, оранжевая рамка — Стенд: вкладка «Редактор плана».
+- Devices: drag иконок, клик открывает редактор маркера — Стенд: вкладка «Редактор устройств».
+- Табы скрыты для не-админа — Стенд: не проверяется (второго, не-админского, пользователя на стенде нет).
+- Открывания во View инертны (дверь/окно — чистый рисунок) — Стенд: во View потыкать дверь в Прихожей мимо бейджа замка — ничего не происходит.
+- Бейдж замка — единственное исключение — Стенд: клик по замочку на двери открывает карточку двери; в редакторе плана он инертен.
+- Курсор pointer во View, grab в Devices — Стенд: сравнить курсор над иконкой в двух режимах.
+- В Plan открывание интерактивно (drag по стенам, 3 px порог) — Стенд: редактор плана → потаскать дверь вдоль стены, одиночный тап открывает свойства.
+
+## Онбординг ★
+
+Все пункты онбординга требуют ПУСТОЙ конфиг. На стенде: Настройки → Устройства и службы → House Plan можно удалить и добавить интеграцию заново, либо стереть все пространства руками — и пройти онбординг; сброс через час всё вернёт.
+- Мастер импорта этажей — Стенд: у демо-дома этажи HA не заведены, мастер предложит «Start from scratch»; полный сценарий с этажами — локально (или создать этажи в Настройки → Зоны и этажи, затем удалить пространства карточки).
+- Остальные пункты мастера (снять галки → Create disabled, очередь диалогов, Skip/Cancel, авто-разметка с тостом, пустое состояние) — Стенд: в рамках того же прогона после удаления пространств.
+
+## Пространства ★
+
+- Создание с картинкой (SVG/PNG/JPG/WebP), чёткость на зуме — Стенд: «+» в шапке → загрузить свой файл (демо-планы нарисованы без подложки — тем интереснее добавить).
+- >8 MB → читаемый тост — Стенд: залить большой файл.
+- «Без изображения — нарисую сам», ориентация — Стенд: «+» → режим рисования.
+- Белый холст в draw-режиме — Стенд: оба демо-пространства такие: борта/имена читаемы на белом.
+- Rename / замена картинки / image→draw отвязывает план — Стенд: ⚙ пространства.
+- Удаление пространства — Стенд: удалить «Двор», убедиться что «1 этаж» не тронут; сброс вернёт.
+- Настройки отображения: борта, имена, цвет+прозрачность, заливки — Стенд: ⚙ «1 этаж» — там всё живое, предпросмотр после сохранения.
+- Заливка «zigbee»: красный→зелёный по среднему LQI — Стенд: ⚙ «1 этаж» → заливка «Сигнал Zigbee»: Гостиная зелёная (LQI ~206), Кабинет красный (~24), Двор не залит (нет zigbee).
+- Заливка «lights» — Стенд: включить, зажечь свет в комнате с плана — комната жёлтая, потушить — серая.
+- Заливка «temperature» + границы комфорта — Стенд: включить: Спальня синяя (~18.7°), Кухня жёлтая (~26°), Гостиная зелёная (~22.8°); границы 20–25 редактируются тут же.
+- Радиогруппа заливок без легенды — Стенд: глазами в ⚙ пространства.
+- Hover затемняет текущую заливку — Стенд: навести на комнату при любой заливке.
+- Тултип комнаты со средней температурой — Стенд: навести на Кухню — «≈26°».
+- Средняя температура только от термометров — Стенд: рядом с «Тёплым полом» (Кабинет) убедиться, что его current_temperature не ломает среднее (в Кабинете свой термометр).
+- Ширина диалога 500 px, компактные поля — Стенд: глазами в ⚙ пространства.
+- Общие настройки (⚙ в шапке): цвета по режимам + Reset — Стенд: покрутить цвета glow/temp/lqi, Reset.
+- Пользовательские цвета и на статичной карточке — Стенд: сменить цвет заливки, открыть вид «Схема».
+- Градиент LQI между настроенными цветами — Стенд: сменить цвета weak/strong в ⚙ и посмотреть заливку zigbee.
+- Per-space «Показывать LQI» — Стенд: выключить в ⚙ «1 этаж» — бейджи цифр у термометров и строка сигнала в тултипах пропадают только там.
+- Центровка бейджа и глифа — Стенд: глазами на любой иконке при максимальном зуме.
+- Hover-подсветка при кастомных бортах — Стенд: покрасить борта и навести.
+- Настройки живут на сервере — Стенд: сменить цвет, открыть стенд в приватном окне/другом браузере — цвет тот же.
+
+## Редактор разметки комнат ★
+
+Всё проверяется в «Редакторе плана» на «1 этаже» (или создайте своё пространство — сброс простит всё).
+- Сетка, снап, общие стены — Стенд: дорисовать комнату впритык к существующей.
+- Линейка сегмента (метры; cm/cell из настроек) — Стенд: начать рисовать контур, смотреть на бегущую длину.
+- Незакрытый контур не сохраняется — Стенд: начать контур, уйти из разметки, вернуться — линий нет.
+- Удаление комнаты бережёт общие стены — Стенд: удалить Прихожую (⚙ комнаты → удалить), стены Кабинета/Спальни на месте; сброс вернёт.
+- Нет инструмента «Erase» в тулбаре — Стенд: глазами.
+- Пересечения запрещены (клик внутри чужой комнаты → тост) — Стенд: попытаться начать контур внутри Гостиной.
+- Контур вокруг существующей комнаты отклоняется — Стенд: обвести Кабинет снаружи.
+- Merge двух смежных / отказ для несмежных — Стенд: слить Кабинет+Прихожую, тост при попытке слить Кабинет+Кухню; сброс вернёт.
+- Split: две точки на стенах, бОльшая часть сохраняет имя — Стенд: разрезать Гостиную; Cancel в диалоге — комната цела.
+- Split с точкой вне стены / вдоль стены → тост — Стенд: там же.
+- Split на не-грид комнатах (снап к стене) — Стенд: комнаты демо на гриде; полноценно — локально, но снап виден: клик чуть мимо стены цепляется.
+- Промах далеко от стены → тост — Стенд: кликнуть в центр комнаты.
+- Esc/Ctrl+Z снимает точку, Reset чистит — Стенд: во время рисования.
+- Замыкание (≥4 точек) → диалог комнаты — Стенд: нарисовать комнату во «Дворе».
+- В диалоге только свободные зоны; выбор зоны подставляет имя — Стенд: все 6 зон заняты — список пуст: создать комнату «без зоны».
+- «Без зоны» требует имя, `area: null` — Стенд: там же.
+- Cancel диалога возвращает контур — Стенд: там же.
+- Сохранение с зоной раскладывает устройства зоны — Стенд: не проверяется как есть (у demo-сущностей нет device registry — автораскладка по зонам не работает, маркеры на стенде явные); полноценно — локально/на даче.
+- Erase удаляет линию, удаление комнаты — полигон — Стенд: инструментом «ластик линий» в тулбаре (клик по своей линии).
+- Иконки скрыты в разметке — Стенд: глазами.
+
+## Устройства на плане ★
+
+- Авто-устройства только в комнатах своей зоны — Стенд: не проверяется (см. выше: без device registry автонаполнение молчит; все маркеры стенда — явные entity-маркеры).
+- Фильтрация мостов/групп/сцен, 👁 «показать все» — Стенд: «Редактор устройств» → 👁: появляются скрытые сущности (сцены/скрипты в списке добавления отфильтрованы).
+- Нумерация дубликатов имён — Стенд: добавить второй маркер той же сущности не даст (занята) — проверяется локально.
+- Группы света сворачивают лампы — Стенд: не проверяется (в демо нет light-групп с device registry).
+- Drag иконок, снап к сетке, позиция per-space — Стенд: редактор устройств: перетащить иконку, F5 — позиция жива; у «Двора» своя раскладка.
+- ↺ сброс автолейаута — Стенд: не проверяется: кнопка Reset убрана в v1.33.2 (пункт в TESTING.md исторический).
+- Бейдж температуры, LQI с цветом — Стенд: под «Zigbee»-термометрами цифра LQI (цвет от красного к зелёному: Кабинет красный, Гостиная зелёный), температура на бейдже.
+- Живые состояния: свет жёлтый, открытая штора оранжевая, unavailable блёклый — Стенд: пощёлкать свет; открыть штору («Открыть шторы» или карточка); unavailable в демо нет — эмулировать нечем, но у робота после паузы всё живое.
+- Морфинг иконок по состоянию — Стенд: дверь/замок: открыть lock.front_door из карточки двери — иконка меняется; гаражные ворота во «Дворе».
+- «Значение вместо иконки» — Стенд: у термометра в диалоге выбрать display «значение» — на плане цифра.
+- RGB только в glow/ripple — Стенд: включить RGBWW-лампу в Гостиной цветом: бейдж жёлтый стандартный, цвет только в пятне glow.
+- Красная пульсация тревоги — Стенд: включить `input_boolean.demo_leak` (Настройки → Устройства и службы → Помощники) — датчик на Кухне пульсирует красным; дым в Спальне сам вспыхивает каждые 10 минут на 30 с.
+- Стоимость рендера (geometry once) — Стенд: не проверяется руками — smoke_render_perf.
+- Тап vs drag открывания — Стенд: редактор плана, тап по двери = свойства, drag на место = ничего не записано.
+- Вогнутый остров — Стенд: нарисовать U-комнату во «Дворе» и остров внутри.
+- Backend hardening (B2–B5) — Стенд: не проверяется руками — unit/backend.
+- Гонка сохранений (markup vs Save) — Стенд: два окна: в одном правка разметки, в другом Save диалога — правка выживает; остальное — тесты.
+- Niche split — Стенд: разрез, начинающийся и кончающийся на одной стене — вырезается ниша.
+- Контент только через подписанные URL — Стенд: залить план, скопировать URL картинки из DevTools, убрать authSig → 401; старые пути `/houseplan_files/plans` → 404.
+- Каждая опция редактора сохраняема — Стенд: перебрать display/tap/fill в диалогах — ошибок валидации быть не должно.
+- Кнопка настроек комнаты в геометрическом центре — Стенд: редактор плана, глазами.
+- Один индикатор всегда (лампа жёлтая в plan-редакторе glow-пространства) — Стенд: включить свет, открыть редактор плана — бейдж жёлтый (glow-слоя там нет).
+- Size/angle parity — Стенд: задать маркеру size 3 / angle 37 в диалоге → и на «Схеме» тоже ×3 и повёрнут.
+- Tap запускает автоматизацию — Стенд: тап по «Открыть шторы» (Гостиная) → диалог подтверждения → штора едет; в диалоге маркера видно «Run» + поиск по automation/script/scene (есть скрипт «Открыть шторы», автоматизация «Вечерний сценарий», сцены «Кино», «Вечер в гостиной»); Esc = не выполнять.
+- Бейджи light-source в glow — Стенд: заливка glow (по умолчанию): у горящей лампы бейдж стандартный (индикатор — пятно), у розетки-«источника света» жёлтый.
+- Множитель размера иконки растит глиф — Стенд: size 3 у любого маркера.
+- Auto-grid parity, ripple ghost, hidden LQI parity, ghost без цифр — Стенд: скрыть «Zigbee»-термометр: LQI комнаты не меняется, «Схема» совпадает с планом; «Show hidden» в редакторе устройств показывает синий пунктирный призрак без значений.
+- Флаг «скрыть с плана» — Стенд: галка в любом диалоге устройства; скрытый исчезает из всех режимов и счётчика, но LQI комнаты держит.
+- «Жёлтый = работает» — Стенд: «Тёплый пол» в Кабинете: hvac_action=heating → жёлтая подложка. (Выключить нагрев можно, поставив target ниже 20° в карточке — бейдж гаснет.)
+- Жесты редактора на touch — Стенд: с телефона в редакторе плана: pinch = zoom, палец = pan, отпускание не ставит точку.
+- Legacy-геометрия, положительные размеры, границы 1e100, no-op repair — Стенд: не проверяется (нужен подложенный битый store, у тестировщика нет доступа к .storage) — unit/backend.
+- Карточка под другим контентом дашборда — Стенд: вид «Схема» — карточка стоит после других карточек и не схлопывается.
+- Stranded migration repair / geometry repair — Стенд: не проверяется руками (WS-команда) — backend.
+- Редакторы видят весь холст — Стенд: «Двор» (одна комната): в редакторе плана виден весь белый квадрат, во View — контент-фит.
+- Save ждёт пропорции выбранного плана — Стенд: прикрепить «уже загруженный» план и мгновенно Save.
+- Зум ниже фита (пол 0.4x) — Стенд: минусовать зум ниже 100%.
+- Migration crash / parallel upload quota — Стенд: не проверяется (kill HA между записями невозможен) — backend.
+- Зум открывается на контенте — Стенд: «Двор» открывается комнатой на весь экран.
+- Удаление используемого плана запрещено — Стенд: залить план, в списке «уже загруженные» его delete неактивен.
+- Квота загрузок — Стенд: можно доливать планы до квоты — тост; сброс почистит.
+- Миграция на квадратный холст — Стенд: не проверяется (миграция уже прошла; нужен старый store) — unit.
+- Картинка плана по центру с полями — Стенд: залить широкую картинку — поля сверху/снизу, без растяжения.
+- Re-attach отвязанного плана — Стенд: ⚙ пространства → «рисование» → Save → reload → «Уже загруженные» → прикрепить обратно.
+- Detach хранит файл — Стенд: там же: после отвязки файл в списке; замена плана убирает старый сразу.
+- Перепривязка не ест мануалы — Стенд: маркер с 2 PDF перепривязать на другую сущность — оба открываются.
+- Ничего не копится на idle — Стенд: не проверяется полноценно (ежечасный сброс раньше суточного sweep) — backend.
+- Drag выигрывает у удалённого move — Стенд: два окна, тащить разные иконки одновременно.
+- Одноимённые загрузки из двух вкладок — Стенд: можно, два вложения обязаны выжить; тонкости — unit.
+- Временные файлы не выживают — Стенд: не проверяется (нужен доступ к ФС) — backend.
+- Две полные карточки согласны в позициях — Стенд: два окна: drag в одном виден во втором без reload.
+- Загруженный SVG инертен (script не исполняется) — Стенд: залить SVG со ``, открыть его подписанный URL в новой вкладке — alert нет, план рендерится.
+- Вложение не перезаписывает другое — Стенд: приложить manual.pdf к двум маркерам — два независимых файла.
+- Два быстрых эдита выживают — Стенд: быстро сделать две правки подряд (throttle сети в DevTools) — обе на месте.
+- Открытые границы следуют геометрии — Стенд: открыть границу (инструмент «Открыть границу») между Гостиной и Кухней, потом утащить вершину стены — разрыв едет вместе.
+- Внутренние лимиты (max+1) — Стенд: не проверяется руками — unit/backend.
+- Большие файлы стримятся (50 MB) — Стенд: можно залить 50 MB мануал и скачать дважды; память HA снаружи не видна — полноценно только локально.
+- Паритет статичной карточки (fill none) — Стенд: у комнаты поставить fill «нет» и сравнить со «Схемой».
+- Layout доходит до статичной карточки — Стенд: drag иконки на «Плане» → на «Схеме» (другая вкладка того же дашборда) двигается.
+- Repair-issue смертны — Стенд: удалить пространство с битым планом… проще: удалить пространство — связанные предупреждения из Настройки → Ремонт исчезают.
+- Не-подписанный путь не зацикливает запросы — Стенд: не проверяется руками — unit.
+- Подписи не усиливаются на плохой сети — Стенд: DevTools throttling + Network: один sign-запрос на URL.
+- Битая папка планов не валит save — Стенд: не проверяется (нужна ФС) — backend.
+- Два редактора, один план — Стенд: две вкладки, залить подложку в каждой по очереди — служится последняя, файлы целы.
+- Фон статичной карточки — Стенд: залить план «1 этажу», открыть «Схему»: картинка есть, в Network нет неподписанных запросов.
+- Отклонённый save не трогает план — Стенд: две вкладки: обе меняют план, вторая получает конфликт — старый план жив.
+- Кэш подписей на 200+ URL — Стенд: не воспроизводимо (нет 200 файлов) — smoke_sign_cap.
+- Климат не дорожает с комнатами — Стенд: не проверяется руками — smoke_climate_once.
+- Upload при конкурентной ревизии — Стенд: две вкладки: приложить фон при открытом втором редакторе.
+- Подписанный фон плана — Стенд: см. выше: authSig в Network, нет failed login в журнале HA (Настройки → Система → Журналы).
+- Зомби-диалоги — Стенд: Esc во время сохранения при throttling — диалог закрыт, тост об ошибке живёт.
+- Нет hover-тултипов на touch — Стенд: с телефона.
+- Слайдеры шрифтов (50–300%) — Стенд: ⚙ пространства + ⚙ комнаты: живой образец в диалоге следует слайдеру.
+- Room settings tier 3 (имя, зона, fill override, источник T°/влажности) — Стенд: ⚙ любой комнаты; источник температуры прописан у комнат демо через зонные термометры — переопределить и посмотреть карточку.
+- PDF переживает перепривязку — Стенд: см. «перепривязка не ест мануалы».
+- Киоск-режим — Стенд: вид «Киоск» дашборда: шапки нет, свайп листает пространства с точками-индикатором, дабл-тап сброс зума, лонг-пресс 3 с на пустом месте — поповер размеров; авто-листание cycle — задано в конфиге вида; реальный планшет — руками на своём.
+- Иконка-ссылка зоны у имени комнаты — Стенд: во View у имён комнат есть ↗ (зоны привязаны) — клик ведёт в зону HA; в редакторах иконки нет.
+- Смарт-гайды — Стенд: тащить иконку в редакторе устройств — пунктирные направляющие от соседей, бейдж длина·угол.
+- Свет тогглится по умолчанию — Стенд: тап по любой лампе во View = вкл/выкл без настройки.
+- Производные стены тоже режутся (.seg) — Стенд: открыть границу и смотреть в редакторе плана: сплошной линии под пунктиром нет.
+- Пунктир открытых границ в разметке — Стенд: там же.
+- Nav-персистентность (пространство+режим) — Стенд: уйти в «Двор», закрыть вкладку, открыть — снова «Двор»; `#space=floor1` в URL сильнее.
+- Чистка tap-действий + правый клик — Стенд: ПКМ по иконке во View = more-info HA.
+- Редизайн секции биндинга — Стенд: «+» в редакторе устройств: радио Виртуальное/Из списка HA, «показать сущности», поиск в дропдауне.
+- Настоящий пунктир открытой границы — Стенд: см. открытые границы.
+- Hover открытия стены — Стенд: инструмент «Открыть границу»: у общей стены курсор pointer + янтарный пунктир-превью; на уже открытой — красное превью.
+- Открытые границы: свет течёт по зоне — Стенд: открыть границу Гостиная-Кухня при glow: свет горящей лампы заливает обе.
+- Секторы дверей не темнят комнату — Стенд: glow: открыть дверь Прихожей, смотреть сектор света.
+- Per-source радиус glow — Стенд: поле «Радиус свечения» в диалоге лампы.
+- Скрытая light-primary — Стенд: не проверяется (нет скрытых-в-реестре ламп в демо) — локально.
+- Marker controls (тогл связки ламп) — Стенд: у «Котла»/виртуального маркера прописать «Управляет источниками света» + Toggle и тапнуть: обе лампы Гостиной разом.
+- Glow fill в целом — Стенд: заливка по умолчанию на «1 этаже»: зажечь RGBWW-лампу цветом — цветное пятно, радиус в ⚙.
+- Островные комнаты — Стенд: нарисовать остров во «Дворе».
+- Иконка не прыгает при перепривязке — Стенд: перепривязать маркер: позиция та же; смена комнаты в том же пространстве тоже не двигает.
+- Плейсхолдер автоиконки — Стенд: диалог без явной иконки: «Auto: mdi:…» с превью.
+- Нет кнопки Reset в тулбаре Devices — Стенд: глазами: add / 👁 / ⬡.
+- Сетка во всех редакторах + fade декора — Стенд: редактор фона: комнаты/иконки блёкнут до 35%, декор яркий.
+- Редактор фона (фигуры/текст/ластик) — Стенд: порисовать во «Дворе»: прямоугольник-«газон», текст.
+- Превью открывания (призрак 90 см) — Стенд: инструмент «Открывание», водить у стены.
+- Split-polyline, курсоры, Esc-цепочка — Стенд: split Гостиной ломаной через середину.
+- Подсветка выбранного в merge/split — Стенд: янтарная обводка первой комнаты.
+- Карточка vs инструмент — Стенд: в редакторе плана тащить карточку комнаты при активном Draw — точек не ставится.
+- Карточки комнат (метрики, drag, resize) — Стенд: включить метрики в ⚙ пространства; в редакторе плана карточку можно тащить и растягивать за углы.
+- Esc закрывает диалоги по одному — Стенд: наоткрывать вложенных диалогов.
+- Общая ⚙ видна во всех режимах — Стенд: глазами.
+- Табы редакторов (2 шт + X) — Стенд: глазами.
+- ⚙ пространства в каждом режиме — Стенд: глазами.
+- Lock action (Unlock красный + подтверждение) — Стенд: карточка двери в Прихожей.
+- Флаг нового устройства (красная точка) — Стенд: включить незанятую сущность… проще: не проверяется напрямую (набор сущностей демо фиксирован; точка была бы у новых) — локально.
+- Ноль устройств в HA — Стенд: не проверяется (в демо 100+ сущностей) — smoke_new_device.
+
+## Диалог устройства (маркеры) ★
+
+- Все поля сохраняются — Стенд: любой маркер: имя/иконка/модель/ссылка/описание, F5.
+- Перепривязка с поиском, занятые исключены — Стенд: дропдаун биндинга: уже размещённые сущности в списке отсутствуют.
+- Виртуальное устройство: имя+комната, пунктир — Стенд: «Котёл» — образец; создать своё.
+- Комнаты без зоны в списке комнат — Стенд: нарисовать комнату «без зоны» и поместить туда маркер.
+- Room override центрирует — Стенд: сменить комнату маркера.
+- Tap-action override — Стенд: перебрать все варианты у одного маркера.
+- PDF: ok / >50 MB / .exe — Стенд: приложить файлы к маркеру; большие и .exe должны дать читаемую ошибку.
+- `javascript:` в ссылке не кликабелен — Стенд: вписать `javascript:alert(1)` в поле ссылки — в карточке не ссылка.
+- Remove: авто → скрытый маркер, виртуальное → насовсем — Стенд: удалить «Котёл» (вернётся сбросом) и любой entity-маркер.
+
+## Правила иконок ★
+
+- ⬡ открывает редактор с текущими правилами — Стенд: редактор устройств → ⬡.
+- Тест-поле, добавление/удаление/порядок — Стенд: там же, ввести имя «Термометр…».
+- Битый regex краснеет и пропускается — Стенд: вписать `([`.
+- Reset к дефолтам — Стенд: там же.
+- Правила переиконивают существующие; per-device иконка сильнее; замки всегда mdi:lock — Стенд: правило `.*свет.* → mdi:star` и смотреть план.
+- Живут после reload и во втором браузере — Стенд: приватное окно.
+
+## Tap-действия и жесты ★
+
+- Тап → карточка, `toggle` тогглит только свет/розетки/вентиляторы — Стенд: пощёлкать лампы (toggle по умолчанию), медиаплеер (карточка).
+- Замки не тогглятся никогда; шторы только с явным override — Стенд: замок двери; штора Гостиной: выставить «Toggle» в диалоге — начнёт тогглиться, гаражные ворота — нет.
+- Long-press всегда карточка — Стенд: зажать лампу на 600 мс — карточка вместо toggle.
+- Drag >3 px отменяет tap/long-press — Стенд: потащить палец с иконки.
+- pointercancel без фантомов — Стенд: с телефона: начать тап и свернуть браузер.
+
+## Zoom / pan / подписи
+
+- Wheel у курсора, +/−, fit, % — Стенд: глазами.
+- Pinch + двухпальцевый pan — Стенд: с телефона.
+- Зум живёт per-space в localStorage — Стенд: зазумить «1 этаж», перейти в «Двор» и назад, F5.
+- Resize окна перефитит — Стенд: свернуть боковую панель HA.
+- Подписи комнат таскаются (rl_*) — Стенд: в редакторе плана утащить имя комнаты, F5.
+- Читаемость подписей на мин/макс зуме — Стенд: глазами на белом плане.
+
+## Мультиклиент ★
+
+- Две вкладки: drag виден без reload — Стенд: два окна рядом.
+- Конфликт конфига → тост, авторесинк, retry — Стенд: два окна: одновременно править настройки пространства.
+- Точечные layout-апдейты не трутся — Стенд: тащить разные иконки в двух окнах.
+- `admin_only` для не-админа — Стенд: не проверяется (нет второго пользователя) — backend.
+
+## Крайние случаи
+
+- HA без устройств/зон — Стенд: не проверяется (демо полон сущностей) — локально.
+- Пространство без комнат — Стенд: создать пустое, видна подсказка разметки.
+- Комната без зоны + борта — Стенд: нарисовать, кликнуть — ничего.
+- Нет zigbee вовсе — Стенд: «Двор»: заливка lqi оставляет двор незалитым, бейджей нет.
+- 100+ устройств в одном пространстве — Стенд: не проверяется (в «1 этаже» ~30 маркеров) — локальная синтетика.
+- Длинные имена — Стенд: переименовать маркер в очень длинное имя.
+- HTML/эмодзи в именах — Стенд: назвать маркер `xss🚿` — текст, не разметка.
+- План удалён с диска → Repairs — Стенд: не проверяется (нет доступа к ФС) — backend.
+- Битый houseplan.config — Стенд: не проверяется (нет доступа к .storage) — backend.
+- Рестарт HA при открытом диалоге — Стенд: Настройки → Система → Перезапустить (админ может!), диалог держать открытым; после рестарта save даст чистую ошибку. Помнить: рестарт контейнера = сброс, но сам HA-рестарт изнутри сброс не триггерит.
+- Legacy layout v1 — Стенд: не проверяется — unit.
+- Киоск холодный старт в приложении — Стенд: Companion app + вид «Киоск», убить и открыть.
+
+## Релизные регрессии
+
+- Ноль ошибок консоли — Стенд: DevTools console на дашборде, в разметке, диалогах, зуме.
+- Ноль houseplan-ошибок в логе HA — Стенд: Настройки → Система → Журналы, фильтр «houseplan».
+- npm test / pytest / CI — Стенд: не про стенд — CI.
+- Скриншоты README — Стенд: не про стенд.
+
+## houseplan-space-card (вид «Схема»)
+
+- Рендер идентичен плану, без шапки — Стенд: вид «Схема» дашборда.
+- Полностью неинтерактивна — Стенд: покликать по «Схеме» — ничего, даже тултипов.
+- Кнопка-футер открывает полную карточку на этом пространстве — Стенд: клик по кнопке под «Схемой».
+- Несколько с разными space — Стенд: «Схема» содержит обе (1 этаж и Двор) — один общий WS-запрос (Network).
+- Неизвестный space → аккуратная ошибка — Стенд: отредактировать вид, вписать space: nope.
+- show_button: false — Стенд: правкой YAML вида.
+- #space= диплинк — Стенд: открыть `…/plan#space=yard`.
+
+## Presence ripples / per-device иконка
+
+- «Только пульсация»: бейдж исчезает, кольца при on — Стенд: у датчика движения «Movement Backyard» (Кухня) поставить display «пульсация» — он периодически on/off сам.
+- «Иконка + пульсация» — Стенд: там же.
+- Цвет и размер ×2..×8 — Стенд: там же.
+- unavailable останавливает пульс — Стенд: не проверяется (нет unavailable-сущностей в демо) — smoke.
+- Размер ×0.5..×3 и поворот; бейджи масштабируются — Стенд: любой маркер.
+- Риплы при выключенных live-состояниях — Стенд: выключить «живые состояния» в конфиге карточки (правка вида) — риплы живут.
+- reduce motion — Стенд: включить в ОС тестера.
+
+## Двери и окна
+
+Дверь с замком (Прихожая, lock.front_door) и окно с датчиком (Кухня, contact = «Basement Floor Wet») уже стоят.
+- Клик мимо стены → тост; у стены → диалог — Стенд: инструмент «Открывание» в разметке.
+- Дверь: косяки+полотно+дуга, длина в см — Стенд: глазами у входной двери.
+- Контакт: open → створка + дуга акцентом — Стенд: датчик окна Кухни переключается сам (это «мокрый пол» из демо — он мигает); либо повесить contact на `binary_sensor.demo_leak` и дёргать помощник.
+- Unavailable → статичный дефолт — Стенд: не проверяется (нет unavailable) — локально.
+- Замок: зелёный/оранжевый/серый бейдж — Стенд: замок двери, открыть/закрыть из карточки.
+- Карточка с двумя состояниями, замок не тогглится с плана — Стенд: клик по двери/замку во View.
+- Flip зеркалит петли/сторону — Стенд: диалог открывания (двойной клик с инструментом).
+- Клик с инструментом → редактирование; Delete — Стенд: там же.
+- Hover: акцент + grab во View — Стенд: навести на дверь.
+- Drag вдоль стен с переснапом за углы — Стенд: тащить дверь по периметру Прихожей.
+- Один клик = карточка, дабл = свойства, drag = ничего — Стенд: там же.
+
+## Живые пылесосы (docs/VACUUM.md)
+
+Симулятор: «Робот-пылесос» в Прихожей (база = маркер), карта `sensor.demo_robot_map`
+в стиле Tasshack (позиция-словарь, комнаты с именами как на плане, mm, ось Y
+перевёрнута), калибровка уже прописана. Полный цикл уборки ~3.5 минуты.
+- Docked: только маркер базы — Стенд: глазами (робот в Прихожей).
+- Уборка: круглая пульсирующая шайба едет, база на месте — Стенд: карточка робота → Start (или Настройки → Устройства и службы → Сущности → vacuum.demo_robot); шайба змейкой объезжает все 5 комнат.
+- Глайд ~1.2 с, телепорт при zoom/pan/switch — Стенд: во время уборки позумить.
+- Режимы следа never/cleaning/always — Стенд: диалог маркера робота → «Показывать путь робота»; в always виден след прошлой уборки (40%) — он уже записан в эталоне.
+- Серверный след (две уборки, переживает reload) — Стенд: запустить уборку, F5 посреди — линия продолжается с места; вторая вкладка видит ту же линию.
+- Стиль: тёмный ореол + светлое ядро — Стенд: глазами поверх glow-заливки.
+- Скрытый маркер: ни шайбы, ни следа — Стенд: скрыть маркер робота на время уборки.
+- Калибровка: «Настроить автоматически» — Стенд: диалог робота → «Живая позиция»: имена комнат карты совпадают с планом (все 5) — автокалибровка сходится; панель подгонки (призрак, углы, поворот, зеркало — зеркало осмысленно: ось Y в карте перевёрнута) тоже можно открыть и покрутить, Esc/Cancel не портит.
+- Мультиэтаж (матрица на карту) — Стенд: частично: карта одна (map 1), матрица хранится по её id; мультикарта — только на реальном Dreame.
+- Pause/Return — Стенд: кнопки в карточке робота: пауза замирает, «домой» возвращает по своим следам с двойной скоростью.
+
+## Чего на стенде нет принципиально
+
+- Реальное Zigbee/Z-Wave железо, реальные роботы (Dreame/Xiaomi/Valetudo), реальный настенный планшет.
+- HACS-путь установки/обновления, YAML-mode Lovelace, переустановка интеграции с сохранением конфига.
+- Всё, что требует доступа к файловой системе стенда: битые store, kill -9 между записями, недоступные папки, наблюдение за памятью процесса.
+- Долгоживущие сценарии (суточный sweep, «часом позже») — сброс стенда наступает раньше.
+- Не-админский пользователь (admin_only, скрытие табов) — на стенде один админ demo.
diff --git a/docs/VACUUM.md b/docs/VACUUM.md
index adedd4c..375b77d 100644
--- a/docs/VACUUM.md
+++ b/docs/VACUUM.md
@@ -91,12 +91,16 @@ marker is edited as usual.
## Setup UX
A «Живая позиция» section in the device dialog, vacuum markers only:
-status line (which source was found / room-only / nothing), one button
-(«Настроить автоматически» for Tier A, «Калибровка по трём точкам» for
-Tier B), three checkboxes (live position / trail / room highlight, all
-on), and for multi-map robots a per-map calibration status list. The
-source entity is discovered via the device registry — no YAML, no
-entity pickers.
+status line (which source was found / nothing), the «Настроить
+автоматически» button (Tier A — the integration reports a room list),
+the «Подогнать вручную» button opening the fit panel (drag the ghost
+map, stretch by the corners, rotate/mirror), one «Живая позиция на
+плане» checkbox (on by default), the «Показывать путь робота» select
+(never / while cleaning / always), and for multi-map robots a list of
+calibrated maps. The source entity is discovered via the device
+registry — no YAML, no entity pickers. The section works before the
+marker is ever saved: the first vacuum edit materialises the marker
+itself (HP-1540-01).
## Storage & validation
diff --git a/package-lock.json b/package-lock.json
index f32d312..e360d2f 100755
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "houseplan-card",
- "version": "1.54.0",
+ "version": "1.54.1",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "houseplan-card",
- "version": "1.54.0",
+ "version": "1.54.1",
"license": "MIT",
"dependencies": {
"lit": "^3.1.3",
diff --git a/package.json b/package.json
index 0e72f0d..5eac2b9 100755
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "houseplan-card",
- "version": "1.54.0",
+ "version": "1.54.1",
"description": "Interactive house plan Lovelace card for Home Assistant",
"license": "MIT",
"type": "module",
diff --git a/src/houseplan-card.ts b/src/houseplan-card.ts
index 09b71d8..14faae1 100755
--- a/src/houseplan-card.ts
+++ b/src/houseplan-card.ts
@@ -42,7 +42,7 @@ import { cardStyles } from './styles';
import { fitInSquare, contentBounds, spaceModels } from './space-geometry';
import { langOf, t, type I18nKey } from './i18n';
-const CARD_VERSION = '1.54.0';
+const CARD_VERSION = '1.54.1';
const LS_KEY = 'houseplan_card_layout_v1';
const LS_CFG = 'houseplan_card_cfg_v1'; // cache of the server config+layout for instant rendering
const LS_ZOOM = 'houseplan_card_zoom_v1';
@@ -4423,6 +4423,35 @@ class HouseplanCard extends LitElement {
+ /**
+ * HP-1540-01: an auto-discovered vacuum has NO config marker until the first
+ * general Save of its dialog, yet the «Живая позиция» section is already
+ * interactive. Every vacuum handler used to `cfg.markers.find(...)` and
+ * silently no-op without one — auto-calibration even toasted success while
+ * saving nothing. Materialise a minimal marker (same id/binding the dialog
+ * Save would produce — see _saveMarker/markerIdForBinding) before any
+ * vacuum write, so the write has somewhere real to land.
+ */
+ private _vacEnsureMarker(d: DevItem): Marker | null {
+ const cfg = this._serverCfg;
+ if (!cfg) return null;
+ cfg.markers = cfg.markers || [];
+ const existing = cfg.markers.find((x: Marker) => x.id === d.id);
+ if (existing) return existing;
+ if ((d.bindingKind !== 'device' && d.bindingKind !== 'entity') || !d.bindingRef) return null;
+ const m: Marker = {
+ id: d.id,
+ binding: d.bindingKind + ':' + d.bindingRef,
+ space: d.space || null,
+ area: d.area || null,
+ // explicit like _saveMarker: a marker of any kind tells the seeder
+ // "the user decided" (docs/FILTERING.md)
+ hidden: d.hidden ? true : false,
+ };
+ cfg.markers.push(m);
+ return m;
+ }
+
/** «Живая позиция» in the device dialog — vacuum markers only. */
private _renderVacSection(dlg: any): TemplateResult | typeof nothing {
const dev = this._devices.find((x) => x.id === dlg.devId);
@@ -4436,8 +4465,9 @@ class HouseplanCard extends LitElement {
: this._t('vac.status_none');
const cals = Object.keys(v.calibration || {});
const setVac = (patch: Record) => {
- const cfg = this._serverCfg;
- const m = cfg?.markers?.find((x: Marker) => x.id === dev.id);
+ // HP-1540-01: materialise the marker first — find() alone silently
+ // dropped every edit for a vacuum that had never been saved
+ const m = this._vacEnsureMarker(dev);
if (!m) return;
m.vacuum = { ...(m.vacuum || {}), ...patch };
this._regSignature = '';
@@ -4481,11 +4511,15 @@ class HouseplanCard extends LitElement {
return sel ? String(sel) : 'default';
}
- /** Persist a solved matrix into marker.vacuum.calibration[mapId]. */
- private _vacSaveMatrix(markerId: string, source: string, mapId: string, matrix: Affine): void {
- const cfg = this._serverCfg;
- const m = cfg?.markers?.find((x: Marker) => x.id === markerId);
- if (!m) return;
+ /** Persist a solved matrix into marker.vacuum.calibration[mapId].
+ * Returns whether the write actually landed — callers must not toast
+ * success otherwise (HP-1540-01). */
+ private _vacSaveMatrix(markerId: string, source: string, mapId: string, matrix: Affine): boolean {
+ // HP-1540-01: a first-use vacuum has no marker yet — materialise it
+ const dev = this._devices.find((x) => x.id === markerId);
+ const m = dev ? this._vacEnsureMarker(dev)
+ : this._serverCfg?.markers?.find((x: Marker) => x.id === markerId);
+ if (!m) return false;
const v = { ...(m.vacuum || {}) };
v.source = source;
v.calibration = { ...(v.calibration || {}), [mapId]: matrix.map((n) => Number(n.toFixed(6))) };
@@ -4493,6 +4527,7 @@ class HouseplanCard extends LitElement {
this._regSignature = '';
this._saveConfig();
this.requestUpdate();
+ return true;
}
/** «Настроить автоматически»: robot rooms ↔ plan rooms by name. */
@@ -4505,9 +4540,14 @@ class HouseplanCard extends LitElement {
}
const sp = this._spaceModel(d.space);
const planRooms = (sp?.rooms || [])
- .filter((r: any) => r.name && r.poly?.length >= 3)
- .map((r: any) => {
- const c = poleOfInaccessibility(r.poly);
+ // HP-1540-04: legacy rectangle rooms (x/y/w/h) are still first-class
+ // everywhere else — roomPoly() gives the same 4-corner outline the
+ // renderer uses, so they must count for name-matching too. The old
+ // r.poly?.length filter dropped them and then blamed the room names.
+ .map((r: any) => ({ r, poly: roomPoly(r) }))
+ .filter(({ r, poly }: any) => r.name && poly)
+ .map(({ r, poly }: any) => {
+ const c = poleOfInaccessibility(poly);
return { name: r.name, cx: c[0], cy: c[1] };
});
const res = autoCalibrate(tele.rooms, planRooms);
@@ -4516,10 +4556,12 @@ class HouseplanCard extends LitElement {
return;
}
// residual gate: 5% of the canvas ≈ 40 cm in a typical house
+ // HP-1540-01: toast success ONLY after the matrix verifiably landed in
+ // the config — the old code always claimed victory, even as a no-op
+ if (!this._vacSaveMatrix(d.id, src, this._vacMapId(d, tele), res.matrix)) return;
if (res.residual > NORM_W * 0.05) {
this._showToast(subst(this._t('vac.autocal_res_warn'), { rooms: String(res.matched.length) }));
}
- this._vacSaveMatrix(d.id, src, this._vacMapId(d, tele), res.matrix);
this._showToast(subst(this._t('vac.autocal_done'), { rooms: String(res.matched.length) }));
}
@@ -4545,9 +4587,10 @@ class HouseplanCard extends LitElement {
private _vacFitSave(): void {
const f = this._vacFit;
if (!f) return;
- this._vacSaveMatrix(f.markerId, f.source, f.mapId, fitMatrix(f.p));
+ // HP-1540-01: no success toast for a save that did not happen
+ const ok = this._vacSaveMatrix(f.markerId, f.source, f.mapId, fitMatrix(f.p));
this._vacFit = null;
- this._showToast(this._t('vac.cal_done'));
+ if (ok) this._showToast(this._t('vac.cal_done'));
}
/** Rotate/mirror around the ghost centre so the map does not fly away. */
diff --git a/src/i18n/en.json b/src/i18n/en.json
index 0ac0786..1c5d96d 100644
--- a/src/i18n/en.json
+++ b/src/i18n/en.json
@@ -363,9 +363,9 @@
"vac.live": "Live position on the plan",
"vac.trail": "Show the robot's path",
"vac.cal_maps": "Calibrated maps: {maps}",
- "vac.autocal_no_rooms": "The integration reports no room list — use point calibration",
- "vac.autocal_no_match": "Room names did not match (need ≥3 in common) — use point calibration",
- "vac.autocal_res_warn": "Matched {rooms} rooms but the fit is rough — verify and refine with points if needed",
+ "vac.autocal_no_rooms": "The integration reports no room list — open “Fit manually”",
+ "vac.autocal_no_match": "Room names did not match (need ≥3 in common) — open “Fit manually”",
+ "vac.autocal_res_warn": "Matched {rooms} rooms but the fit is rough — verify and refine via “Fit manually” if needed",
"vac.autocal_done": "Done: bound via {rooms} rooms. Start a cleanup and check",
"vac.cal_need_pos": "The robot is not reporting coordinates — start a cleanup and pause it",
"vac.cal_done": "Calibration saved. Start a cleanup and check",
diff --git a/src/i18n/ru.json b/src/i18n/ru.json
index 5fc0264..8c1161b 100644
--- a/src/i18n/ru.json
+++ b/src/i18n/ru.json
@@ -363,9 +363,9 @@
"vac.live": "Живая позиция на плане",
"vac.trail": "Показывать путь робота",
"vac.cal_maps": "Откалиброваны карты: {maps}",
- "vac.autocal_no_rooms": "Интеграция не отдаёт список комнат — используйте калибровку по точкам",
- "vac.autocal_no_match": "Не совпали имена комнат (нужно ≥3 общих) — используйте калибровку по точкам",
- "vac.autocal_res_warn": "Совпало комнат: {rooms}, но привязка грубовата — проверьте и при необходимости откалибруйте по точкам",
+ "vac.autocal_no_rooms": "Интеграция не отдаёт список комнат — откройте «Подогнать вручную»",
+ "vac.autocal_no_match": "Не совпали имена комнат (нужно ≥3 общих) — откройте «Подогнать вручную»",
+ "vac.autocal_res_warn": "Совпало комнат: {rooms}, но привязка грубовата — проверьте и при необходимости откройте «Подогнать вручную»",
"vac.autocal_done": "Готово: привязка по {rooms} комнатам. Запустите уборку и проверьте",
"vac.cal_need_pos": "Робот сейчас не отдаёт координаты — запустите уборку и поставьте на паузу",
"vac.cal_done": "Калибровка сохранена. Запустите уборку и проверьте",
diff --git a/src/vacuum.ts b/src/vacuum.ts
index 8cba9b2..2142e58 100755
--- a/src/vacuum.ts
+++ b/src/vacuum.ts
@@ -81,6 +81,19 @@ const num = (v: unknown): number | null => {
return Number.isFinite(n) ? n : null;
};
+/**
+ * Map-id normalisation contract, shared with the backend recorder
+ * (custom_components/houseplan/trails.py: resolve_map_id). The FIRST value
+ * that is not null/undefined wins — truthiness is wrong here, because a
+ * zero-based `map_index: 0` is a perfectly valid first map and an empty
+ * string is still an id. The backend used an `or`-chain and dropped the
+ * zero, so server trails were stored under a key the renderer never looked
+ * up (HP-1540-02).
+ */
+export function vacMapIdFromAttrs(attrs: Record): string {
+ return String(attrs.map_name ?? attrs.current_map ?? attrs.map_index ?? attrs.selected_map ?? 'default');
+}
+
/**
* Normalise the attribute zoo. One parser instead of per-brand classes: the
* three Tier-A integrations (Xiaomi Cloud Map Extractor, Tasshack
@@ -134,7 +147,7 @@ export function readVacTelemetry(attrs: Record | null | undefined):
rooms.push(room);
}
}
- const mapId = String(attrs.map_name ?? attrs.current_map ?? attrs.map_index ?? attrs.selected_map ?? 'default');
+ const mapId = vacMapIdFromAttrs(attrs);
if (!pos && !rooms.length && !path) return null;
return { pos, path, rooms, mapId };
}
diff --git a/test/i18n.test.mjs b/test/i18n.test.mjs
index af7795c..b418854 100644
--- a/test/i18n.test.mjs
+++ b/test/i18n.test.mjs
@@ -25,3 +25,11 @@ test('i18n: placeholders match between languages', () => {
assert.equal(ph(en[k]), ph(ru[k]), `placeholder mismatch in ${k}`);
}
});
+
+test('vac toasts never mention the removed point calibration (HP-1540-06)', () => {
+ for (const [lang, d] of [['en', en], ['ru', ru]]) {
+ for (const k of ['vac.autocal_no_rooms', 'vac.autocal_no_match', 'vac.autocal_res_warn']) {
+ assert.ok(!/point|точк/i.test(d[k]), `${lang}:${k} still points at point calibration`);
+ }
+ }
+});
diff --git a/test/vacuum.test.mjs b/test/vacuum.test.mjs
index 354ae2c..829d3e6 100644
--- a/test/vacuum.test.mjs
+++ b/test/vacuum.test.mjs
@@ -1,6 +1,6 @@
import test from 'node:test';
import assert from 'node:assert/strict';
-import { solveAffine, applyAffine, affineResidual, readVacTelemetry, autoCalibrate, thinPath, pushTrailPoint, isVacMoving, isVacSourceState } from '../test-build/vacuum.js';
+import { solveAffine, applyAffine, affineResidual, readVacTelemetry, autoCalibrate, thinPath, pushTrailPoint, isVacMoving, isVacSourceState, vacMapIdFromAttrs } from '../test-build/vacuum.js';
test('solveAffine recovers rotation+scale+mirror+offset exactly', () => {
// target = mirror-X, rotate 90°, scale 0.02, offset (300, 400)
@@ -135,3 +135,20 @@ test('fitMatrix/fitFromMatrix round-trip, mirror and quarters', async () => {
const c2 = applyAffine(fitMatrix(r2), 500, 500);
assert.ok(Math.abs(c2[0] - c[0]) < 1e-6 && Math.abs(c2[1] - c[1]) < 1e-6);
});
+
+// HP-1540-02: the map-id contract, mirrored by trails.py resolve_map_id —
+// the first value that is not null/undefined wins; zero and '' are valid ids.
+test('vacMapIdFromAttrs: first NOT-nullish value wins, zero survives', () => {
+ assert.equal(vacMapIdFromAttrs({ map_index: 0 }), '0');
+ assert.equal(vacMapIdFromAttrs({ map_index: '0' }), '0');
+ assert.equal(vacMapIdFromAttrs({ map_name: '', selected_map: 'Floor' }), '');
+ assert.equal(vacMapIdFromAttrs({ map_name: 'A', map_index: 0 }), 'A');
+ assert.equal(vacMapIdFromAttrs({ current_map: 2 }), '2');
+ assert.equal(vacMapIdFromAttrs({ selected_map: 'Vac' }), 'Vac');
+ assert.equal(vacMapIdFromAttrs({}), 'default');
+});
+
+test('readVacTelemetry keeps numeric zero map_index as map id (HP-1540-02)', () => {
+ const t = readVacTelemetry({ vacuum_position: { x: 1, y: 2 }, map_index: 0 });
+ assert.equal(t.mapId, '0');
+});
diff --git a/tests_backend/test_trail_recorder.py b/tests_backend/test_trail_recorder.py
index adcff4a..069bb76 100644
--- a/tests_backend/test_trail_recorder.py
+++ b/tests_backend/test_trail_recorder.py
@@ -85,7 +85,7 @@ def _rec():
}
hass = Hass(states)
rec = trails.TrailRecorder(hass, None)
- rec.pairs = {"camera.map": ("m1", "vacuum.x50")}
+ rec.pairs = {"camera.map": [("m1", "vacuum.x50")]}
return rec, hass, states
@@ -140,3 +140,180 @@ def test_object_style_position_is_read():
states["camera.map"] = S("idle", {"vacuum_position": Point(2020, 3096), "map_index": 1})
assert rec._sample("camera.map", 5.0)
assert rec.book.data["m1"]["current"]["points"] == [[2020.0, 3096.0]]
+
+
+def test_unavailable_vacuum_is_no_verdict():
+ # HA boot: the vacuum reads unavailable — the open run must NOT be ended
+ rec, _hass, states = _rec()
+ rec._sample("camera.map", 1.0)
+ states["vacuum.x50"] = S("unavailable", {})
+ assert not rec._sample("camera.map", 2.0)
+ assert rec.book.data["m1"]["current"]["ended"] is None
+ del states["vacuum.x50"]
+ assert not rec._sample("camera.map", 3.0)
+ assert rec.book.data["m1"]["current"]["ended"] is None
+
+
+# ---------------- v1.54.0 audit regressions ----------------
+
+def _run_isolated(coro):
+ """Run a coroutine on a private loop WITHOUT touching the ambient one.
+
+ asyncio.run() clears the thread's current-loop slot when it finishes; in
+ the CI HA harness (pytest-asyncio keeps a session event loop) that
+ poisoned the setup of every test that followed — 'There is no current
+ event loop in thread MainThread' across whole files.
+ """
+ import asyncio
+ loop = asyncio.new_event_loop()
+ try:
+ return loop.run_until_complete(coro)
+ finally:
+ loop.close()
+
+
+
+
+def test_map_index_zero_matches_frontend_contract():
+ # HP-1540-02: `map_index: 0` is a VALID first map. The old or-chain
+ # dropped it and fell through to selected_map — the server stored the
+ # run under a key the renderer never looked up.
+ rec, _hass, states = _rec()
+ states["camera.map"] = S("idle", {"vacuum_position": {"x": 10, "y": 20}, "map_index": 0})
+ assert rec._sample("camera.map", 1.0)
+ assert rec.book.data["m1"]["current"]["map_id"] == "0"
+
+
+def test_map_id_contract_first_not_none_wins():
+ # HP-1540-02: the shared contract — first NOT-None value, stringified
+ cases = [
+ ({"map_index": 0}, {"selected_map": "Floor"}, "0"),
+ ({"map_index": "0"}, {}, "0"),
+ ({"map_name": ""}, {"selected_map": "Floor"}, ""),
+ ({"map_name": "A", "map_index": 0}, {}, "A"),
+ ({"current_map": 2}, {}, "2"),
+ ({"selected_map": "Src"}, {"selected_map": "Vac"}, "Src"),
+ ({}, {"selected_map": "Vac"}, "Vac"),
+ ({}, {}, "default"),
+ ]
+ for src_attrs, vac_attrs, want in cases:
+ assert trails.resolve_map_id(src_attrs, vac_attrs) == want, (src_attrs, vac_attrs)
+
+
+def test_one_source_two_floor_markers_both_record():
+ # HP-1540-03: the multi-floor case — the same robot placed on two floors.
+ # Both markers must receive the server-side run, on every map.
+ states = {
+ "vacuum.x50": S("cleaning", {}),
+ "camera.map": S("idle", {"vacuum_position": {"x": 100, "y": 200}, "map_index": 0}),
+ }
+ hass = Hass(states)
+ rec = trails.TrailRecorder(hass, None)
+ rec.pairs = {"camera.map": [("m_floor1", "vacuum.x50"), ("m_floor2", "vacuum.x50")]}
+ rec._on_state(E("camera.map"))
+ # the robot moves to the second map: BOTH books rotate to the new run
+ states["camera.map"] = S("idle", {"vacuum_position": {"x": 300, "y": 400}, "map_index": 1})
+ rec._on_state(E("camera.map"))
+ for marker in ("m_floor1", "m_floor2"):
+ book = rec.book.data[marker]
+ assert book["previous"]["map_id"] == "0", marker
+ assert book["previous"]["points"] == [[100.0, 200.0]], marker
+ assert book["current"]["map_id"] == "1", marker
+ assert book["current"]["points"] == [[300.0, 400.0]], marker
+
+
+def test_refresh_builds_pair_lists_and_dedups_subscription():
+ # HP-1540-03: two markers over one source/vacuum → one entity set, both pairs
+ import asyncio
+
+ tracked = []
+
+ def track(hass, ents, cb):
+ tracked.append(list(ents))
+ return lambda: None
+
+ old_track = trails.async_track_state_change_event
+ trails.async_track_state_change_event = track
+ try:
+ cfgm = [
+ {"id": "m_f1", "binding": "entity:vacuum.x50", "vacuum": {"source": "camera.map"}},
+ {"id": "m_f2", "binding": "entity:vacuum.x50", "vacuum": {"source": "camera.map"}},
+ ]
+
+ class CS:
+ async def async_load(self):
+ return {"config": {"markers": cfgm}}
+
+ class RT:
+ config_store = CS()
+
+ hass = Hass({
+ "vacuum.x50": S("docked", {}),
+ "camera.map": S("idle", {}),
+ })
+ rec = trails.TrailRecorder(hass, RT())
+ _run_isolated(rec.async_refresh())
+ assert rec.pairs == {"camera.map": [("m_f1", "vacuum.x50"), ("m_f2", "vacuum.x50")]}
+ assert tracked == [["camera.map", "vacuum.x50"]]
+ finally:
+ trails.async_track_state_change_event = old_track
+
+
+def test_overlapping_refreshes_leave_one_subscription_teardown_zero():
+ # HP-1540-05: two config/set refreshes racing across the awaited load used
+ # to BOTH subscribe; teardown removed only the last handle and the other
+ # callback leaked until HA restart.
+ import asyncio
+
+ active = []
+ seq = {"n": 0}
+
+ def track(hass, ents, cb):
+ seq["n"] += 1
+ hid = seq["n"]
+ active.append(hid)
+ return lambda: active.remove(hid)
+
+ old_track = trails.async_track_state_change_event
+ trails.async_track_state_change_event = track
+ try:
+ gate = asyncio.Event()
+
+ class CS:
+ async def async_load(self):
+ await gate.wait()
+ return {"config": {"markers": [
+ {"id": "m1", "binding": "entity:vacuum.x50", "vacuum": {"source": "camera.map"}},
+ ]}}
+
+ class RT:
+ config_store = CS()
+
+ hass = Hass({
+ "vacuum.x50": S("docked", {}),
+ "camera.map": S("idle", {}),
+ })
+
+ async def scenario():
+ rec = trails.TrailRecorder(hass, RT())
+ t1 = asyncio.ensure_future(rec.async_refresh())
+ t2 = asyncio.ensure_future(rec.async_refresh())
+ for _ in range(3): # both tasks are launched; one parks on the gate
+ await asyncio.sleep(0)
+ gate.set()
+ await t1
+ await t2
+ assert len(active) == 1, f"exactly one live subscription, got {active}"
+ # teardown during an in-flight refresh must also end with zero
+ gate.clear()
+ t3 = asyncio.ensure_future(rec.async_refresh())
+ for _ in range(3):
+ await asyncio.sleep(0)
+ rec.teardown()
+ gate.set()
+ await t3
+ assert active == [], f"teardown must leave zero subscriptions, got {active}"
+
+ _run_isolated(scenario())
+ finally:
+ trails.async_track_state_change_event = old_track