-
Пространств пока нет.
- ${this._serverStorage?j`Добавьте первое пространство и загрузите план этажа.
+${this._t("empty.no_spaces")}
+ ${this._serverStorage?F`${this._t("empty.add_first")}
`:j`Установите интеграцию House Plan и добавьте запись в «Устройства и службы».
`} +${this._t("empty.install")}
`}${this._toast}
`:B}
- ${this._toast}
`:B}
+
- ${t.map(t=>j`
- ${s.length} устр.
+ ${this._t("count.devices",{n:s.length})}
-
+
-
+ title=${this._t("title.zoom_reset")}>
- ${this._norm?j`
-
${this._roomDialog?this._renderRoomDialog():B}
${this._spaceDialog?this._renderSpaceDialog():B}
${this._markerDialog?this._renderMarkerDialog():B}
${this._infoCard?this._renderInfoCard():B}
- ${this._tip?j`
- ${this._tip.title}${this._tip.meta?j`${this._tip.meta}`:B}
- ${null!=this._tip.lqi?j`средний сигнал zigbee:
- ${this._tip.lqi}`:B}
+ ${this._tip?F`
+ ${null!=r?F`${r}°`:B}
+ ${null!=n?F`${n}`:B}
+
`}_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)]}_renderMarkupDefs(t){const e=this._gridPitch,i=.14*e;return j`
+ ${this._tip.title}${this._tip.meta?F`${this._tip.meta}`:B}
+ ${null!=this._tip.lqi?F`${this._t("tip.lqi")}
+ ${this._tip.lqi}`:B}
`:B}
- ${this._toast?j`${this._toast}
`:B}
+ ${this._toast?F`${this._toast}
`:B}
- `}_renderDevice(t,e){const i=this._pos(t),s=(i.x-e.x)/e.w*100,a=(i.y-e.y)/e.h*100,o=this._stateClass(t),n=this._liveTemp(t),r=this._config?.show_signal&&!t.virtual?$t(this.hass,t.entities):null;return j`this._clickDevice(e,t)}
- @mousemove=${e=>this._showTip(e,t.name,t.model+(null!=n?" · "+n+"°":"")+(null!=r?" · LQI "+r:""))}
+ @mousemove=${e=>this._showTip(e,t.name,t.model+(null!=r?" · "+r+"°":"")+(null!=n?" · LQI "+n:""))}
@mouseleave=${()=>this._tip=null}
@pointerdown=${e=>this._pointerDown(e,t)}
@pointermove=${e=>this._pointerMove(e,t)}
@pointerup=${e=>this._pointerUp(e,t)}
>
`}_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)]}_renderMarkupDefs(t){const e=this._gridPitch,i=.14*e;return F`
+ ${i.map((t,e)=>j`
this._infoCard=null}>
0){s.textContent=w?w.emptyScript:"";for(let i=0;iE(t)||"function"==typeof t?.[Symbol.iterator])(t)?this.k(t):this._(t)}O(t){return this._$AA.parentNode.insertBefore(t,this._$AB)}T(t){this._$AH!==t&&(this._$AR(),this._$AH=this.O(t))}_(t){this._$AH!==B&&P(this._$AH)?this._$AA.nextSibling.data=t:this.T(M.createTextNode(t)),this._$AH=t}$(t){const{values:e,_$litType$:i}=t,s="number"==typeof i?this._$AC(t):(void 0===i.el&&(i.el=X.createElement(Z(i.h,i.h[0]),this.options)),i);if(this._$AH?._$AD===s)this._$AH.p(e);else{const t=new G(s,this),i=t.u(this.options);t.p(e),this.T(i),this._$AH=t}}_$AC(t){let e=K.get(t.strings);return void 0===e&&K.set(t.strings,e=new X(t)),e}k(t){E(this._$AH)||(this._$AH=[],this._$AR());const e=this._$AH;let i,s=0;for(const a of t)s===e.length?e.push(i=new Q(this.O(D()),this.O(D()),this,this.options)):i=e[s],i._$AI(a),s++;s2||""!==i[0]||""!==i[1]?(this._$AH=Array(i.length-1).fill(new String),this.strings=i):this._$AH=B}_$AI(t,e=this,i,s){const a=this.strings;let o=!1;if(void 0===a)t=J(this,t,e,0),o=!P(t)||t!==this._$AH&&t!==W,o&&(this._$AH=t);else{const s=t;let n,r;for(t=a[0],n=0;n{const s=i?.renderBefore??e;let a=s._$litPart$;if(void 0===a){const t=i?.renderBefore??null;s._$litPart$=a=new Q(e.insertBefore(D(),t),t,void 0,i??{})}return a._$AI(t),a})(e,this.renderRoot,this.renderOptions)}connectedCallback(){super.connectedCallback(),this._$Do?.setConnected(!0)}disconnectedCallback(){super.disconnectedCallback(),this._$Do?.setConnected(!1)}render(){return W}}rt._$litElement$=!0,rt.finalized=!0,nt.litElementHydrateSupport?.({LitElement:rt});const lt=nt.litElementPolyfillSupport;lt?.({LitElement:rt}),(nt.litElementVersions??=[]).push("4.2.2");const ct=new Set(["hacs","sun","backup","hassio","met","telegram_bot","mobile_app","systemmonitor","better_thermostat","adaptive_lighting","yandex_pogoda","upnp_serial_number"]),ht=[[/протечк/,"mdi:water-alert"],[/клапан/,"mdi:pipe-valve"],[/дым/,"mdi:smoke-detector"],[/термоголов/,"mdi:radiator"],[/температ/,"mdi:thermometer"],[/qingping|air monitor|молекул/,"mdi:air-filter"],[/штор/,"mdi:roller-shade"],[/розетк|plug/,"mdi:power-socket-de"],[/выключат|switch/,"mdi:light-switch"],[/лампа|лампочк|bulb|gx53|светильник|rgb/,"mdi:lightbulb"],[/камер|camera/,"mdi:cctv"],[/замок|ttlock|lock|sn609|sn9161/,"mdi:lock"],[/ворота|garage/,"mdi:garage-variant"],[/калитк|door|открыт/,"mdi:door"],[/счётчик|счетчик|kws|meter/,"mdi:meter-electric"],[/вводный автомат|breaker|wifimcbn/,"mdi:electric-switch"],[/myheat|котёл|котел|boiler|отоплен/,"mdi:water-boiler"],[/холодильник|fridge/,"mdi:fridge"],[/стиральн|washer/,"mdi:washing-machine"],[/сушилк|dryer/,"mdi:tumble-dryer"],[/пылесос|vacuum|dreame/,"mdi:robot-vacuum"],[/soundbar|колонк|станц/,"mdi:soundbar"],[/tv|телевизор|hyundaitv|mitv/,"mdi:television"],[/keenetic|роутер|router/,"mdi:router-wireless"],[/ибп|ups|kirpich/,"mdi:battery-charging-high"],[/slzb|координат|zigbee/,"mdi:zigbee"]];function dt(t,e){const i=((t||"")+" "+(e||"")).toLowerCase();for(const[t,e]of ht)if(t.test(i))return e;return"mdi:chip"}const pt=["light","switch","cover","valve","lock","climate","fan","media_player","camera","vacuum","humidifier","water_heater","alarm_control_panel","sensor","binary_sensor","event","button","number","select","update"];function ut(t){const e=Math.max(0,Math.min(120,(t-40)/140*120));return`hsl(${Math.round(e)}, 85%, 55%)`}function _t(t,e){return Math.round(t/e)*e}function gt(t){return t.length?Math.round(t.reduce((t,e)=>t+e,0)/t.length):null}function mt(t,e){if(e>t[2]/t[3]){const i=t[3],s=t[3]*e;return{x:t[0]-(s-t[2])/2,y:t[1],w:s,h:i}}const i=t[2],s=t[2]/e;return{x:t[0],y:t[1]-(s-t[3])/2,w:i,h:s}}function ft(t,e,i,s){if(t.length<2)return;const a=e.x+s,o=e.x+e.w-s,n=e.y+s,r=e.y+e.h-s;for(let e=0;e<60;e++){let e=!1;for(let s=0;s({eid:e,reg:t.entities[e],st:t.states[e]})).filter(t=>t.reg&&!t.reg.hidden),a=s.filter(t=>!t.reg.entity_category),o=a.length?a:s;if("mdi:thermometer"===i||"mdi:air-filter"===i){const e=o.find(e=>yt(t,e.eid));if(e)return e.eid}for(const t of pt){const e=o.find(e=>e.eid.split(".")[0]===t);if(e)return e.eid}return o[0]?.eid}function $t(t,e){const i=[];for(const s of e){const e=t.states[s];if(!e)continue;const a=(e.attributes?.unit_of_measurement||"").toLowerCase();if(/_(linkquality|lqi)$/.test(s)||"lqi"===a){const t=parseFloat(e.state);isNaN(t)||i.push(t);continue}const o=e.attributes?.linkquality??e.attributes?.lqi;if(null!=o){const t=parseFloat(o);isNaN(t)||i.push(t)}}return gt(i)}function wt(t,e){for(const i of e){if(!yt(t,i))continue;const e=t.states[i];if(!e)continue;const s=parseFloat(e.state);if(!isNaN(s))return Math.round(10*s)/10}return null}function kt(t,e){t.marker=e,e.name&&(t.name=e.name),e.icon&&(t.icon=e.icon),null!=e.model&&(t.model=e.model),t.link=e.link??null,t.description=e.description??null,t.pdfs=e.pdfs||[]}function St(t){const{hass:e,areaToSpace:i,markers:s,settings:a,excluded:o,showAll:n,firstSpaceId:r}=t,l=!1!==a.group_lights,c=function(t,e){if(!e)return[];const i=[];for(const[e,s]of Object.entries(t.entities)){if(!e.startsWith("light.")||s.hidden)continue;let a=null;if("group"===s.platform)a=s.area_id||null;else{if(!s.device_id)continue;{const e=t.devices[s.device_id];if("Group"!==e?.model)continue;a=e.area_id||s.area_id||null}}if(!a)continue;const o=t.states[e];i.push({eid:e,name:s.name||o?.attributes?.friendly_name||e,area:a})}return i}(e,l),h=new Set(c.map(t=>t.area)),d=function(t){const e={};for(const[i,s]of Object.entries(t.entities))s?.device_id&&(e[s.device_id]=e[s.device_id]||[]).push(i);return e}(e),p=new Set;for(const t of s){const[e,i]=t.binding.split(":");"device"!==e&&"entity"!==e||!i||p.add(t.binding)}const u=(t,e)=>s.find(i=>i.binding===t+":"+e),_={},g=[];for(const t of Object.values(e.devices)){const s=t.area_id;if(!s||!i[s])continue;if("service"===t.entry_type)continue;if(p.has("device:"+t.id))continue;const a=u("device",t.id);if(a&&a.hidden)continue;const r=d[t.id]||[],c=bt(e,t,r);if(!n){if(o.has(c))continue;if("Group"===t.model)continue;if(/scene/i.test(t.model||""))continue;if(/bridge/i.test((t.model||"")+(t.name||"")))continue;if("myheat"===c&&t.via_device_id)continue}const m=(t.name_by_user||t.name||"без имени").trim(),f=m+"|"+s;let v=dt(m,t.model);if(r.some(t=>t.startsWith("lock."))&&(v="mdi:lock"),!n&&l&&"mdi:lightbulb"===v&&h.has(s))continue;_[f]=(_[f]||0)+1;const b=_[f]>1?m+" "+_[f]:m,y={id:t.id,name:b,model:t.model||"",area:s,space:i[s],icon:v,entities:r,bindingKind:"device",bindingRef:t.id,pdfs:[]};y.primary=xt(e,r,v),"mdi:thermometer"!==v&&"mdi:air-filter"!==v||(y.temp=wt(e,r)),g.push(y)}for(const t of c)i[t.area]&&(p.has("entity:"+t.eid)||g.push({id:"lg_"+t.eid,name:t.name,model:"группа света",area:t.area,space:i[t.area],icon:"mdi:lightbulb-group",entities:[t.eid],primary:t.eid,bindingKind:"entity",bindingRef:t.eid,pdfs:[]}));for(const t of s){if(t.hidden)continue;const[s,a]=t.binding.split(":");if("device"===s){const s=e.devices[a],o=t.area||s?.area_id||"",n=o&&i[o]||t.space||r,l=s&&d[s.id]||[];let c=s?dt(s.name_by_user||s.name||"",s.model):"mdi:help-circle";l.some(t=>t.startsWith("lock."))&&(c="mdi:lock");const h={id:t.id,name:s?.name_by_user||s?.name||"устройство",model:s?.model||"",area:o,space:n,icon:c,entities:l,bindingKind:"device",bindingRef:a};h.primary=xt(e,l,c),"mdi:thermometer"!==c&&"mdi:air-filter"!==c||(h.temp=wt(e,l)),kt(h,t),g.push(h)}else if("entity"===s){const s=e.entities[a],o=t.area||s?.area_id||s?.device_id&&e.devices[s.device_id]?.area_id||"",n=o&&i[o]||t.space||r,l=e.states[a],c={id:t.id,name:s?.name||l?.attributes?.friendly_name||a,model:"",area:o,space:n,icon:"mdi:shape-outline",entities:[a],primary:a,bindingKind:"entity",bindingRef:a};kt(c,t),g.push(c)}else{const e=t.area||"",s=t.space||e&&i[e]||r,a={id:t.id,name:t.name||"виртуальное устройство",model:t.model||"",area:e,space:s,icon:t.icon||"mdi:map-marker",entities:[],bindingKind:"virtual",virtual:!0};kt(a,t),g.push(a)}}return g}const Ct={title:"Заголовок",default_floor:"Пространство по умолчанию",icon_size:"Размер иконок, % ширины плана",show_temperature:"Показывать температуру",live_states:"Живые состояния (вкл/выкл, открыто…)",show_signal:"Показывать сигнал zigbee (LQI)"};class At extends rt{constructor(){super(...arguments),this._spaces=null,this._spacesLoading=!1}setConfig(t){this._config=t}async _loadSpaces(){if(!this._spaces&&!this._spacesLoading&&this.hass){this._spacesLoading=!0;try{const t=await this.hass.callWS({type:"houseplan/config/get"});this._spaces=(t?.config?.spaces||[]).map(t=>({value:t.id,label:t.title||t.id}))}catch{this._spaces=[]}finally{this._spacesLoading=!1}}}get _schema(){const t=this._spaces||[];return[{name:"title",selector:{text:{}}},t.length?{name:"default_floor",selector:{select:{mode:"dropdown",options:t}}}:{name:"default_floor",selector:{text:{}}},{name:"icon_size",selector:{number:{min:1,max:6,step:.1,mode:"box"}}},{name:"show_temperature",selector:{boolean:{}}},{name:"live_states",selector:{boolean:{}}},{name:"show_signal",selector:{boolean:{}}}]}render(){return this.hass&&this._config?(this._loadSpaces(),j`t:t=>t instanceof CSSStyleSheet?(t=>{let e="";for(const i of t.cssRules)e+=i.cssText;return(t=>new a("string"==typeof t?t:t+"",void 0,i))(e)})(t):t,{is:r,defineProperty:n,getOwnPropertyDescriptor:l,getOwnPropertyNames:c,getOwnPropertySymbols:h,getPrototypeOf:d}=Object,p=globalThis,_=p.trustedTypes,u=_?_.emptyScript:"",m=p.reactiveElementPolyfillSupport,g=(t,e)=>t,f={toAttribute(t,e){switch(e){case Boolean:t=t?u:null;break;case Object:case Array:t=null==t?t:JSON.stringify(t)}return t},fromAttribute(t,e){let i=t;switch(e){case Boolean:i=null!==t;break;case Number:i=null===t?null:Number(t);break;case Object:case Array:try{i=JSON.parse(t)}catch(t){i=null}}return i}},v=(t,e)=>!r(t,e),b={attribute:!0,type:String,converter:f,reflect:!1,useDefault:!1,hasChanged:v};Symbol.metadata??=Symbol("metadata"),p.litPropertyMetadata??=new WeakMap;let y=class extends HTMLElement{static addInitializer(t){this._$Ei(),(this.l??=[]).push(t)}static get observedAttributes(){return this.finalize(),this._$Eh&&[...this._$Eh.keys()]}static createProperty(t,e=b){if(e.state&&(e.attribute=!1),this._$Ei(),this.prototype.hasOwnProperty(t)&&((e=Object.create(e)).wrapped=!0),this.elementProperties.set(t,e),!e.noAccessor){const i=Symbol(),s=this.getPropertyDescriptor(t,i,e);void 0!==s&&n(this.prototype,t,s)}}static getPropertyDescriptor(t,e,i){const{get:s,set:a}=l(this.prototype,t)??{get(){return this[e]},set(t){this[e]=t}};return{get:s,set(e){const o=s?.call(this);a?.call(this,e),this.requestUpdate(t,o,i)},configurable:!0,enumerable:!0}}static getPropertyOptions(t){return this.elementProperties.get(t)??b}static _$Ei(){if(this.hasOwnProperty(g("elementProperties")))return;const t=d(this);t.finalize(),void 0!==t.l&&(this.l=[...t.l]),this.elementProperties=new Map(t.elementProperties)}static finalize(){if(this.hasOwnProperty(g("finalized")))return;if(this.finalized=!0,this._$Ei(),this.hasOwnProperty(g("properties"))){const t=this.properties,e=[...c(t),...h(t)];for(const i of e)this.createProperty(i,t[i])}const t=this[Symbol.metadata];if(null!==t){const e=litPropertyMetadata.get(t);if(void 0!==e)for(const[t,i]of e)this.elementProperties.set(t,i)}this._$Eh=new Map;for(const[t,e]of this.elementProperties){const i=this._$Eu(t,e);void 0!==i&&this._$Eh.set(i,t)}this.elementStyles=this.finalizeStyles(this.styles)}static finalizeStyles(t){const e=[];if(Array.isArray(t)){const i=new Set(t.flat(1/0).reverse());for(const t of i)e.unshift(o(t))}else void 0!==t&&e.push(o(t));return e}static _$Eu(t,e){const i=e.attribute;return!1===i?void 0:"string"==typeof i?i:"string"==typeof t?t.toLowerCase():void 0}constructor(){super(),this._$Ep=void 0,this.isUpdatePending=!1,this.hasUpdated=!1,this._$Em=null,this._$Ev()}_$Ev(){this._$ES=new Promise(t=>this.enableUpdating=t),this._$AL=new Map,this._$E_(),this.requestUpdate(),this.constructor.l?.forEach(t=>t(this))}addController(t){(this._$EO??=new Set).add(t),void 0!==this.renderRoot&&this.isConnected&&t.hostConnected?.()}removeController(t){this._$EO?.delete(t)}_$E_(){const t=new Map,e=this.constructor.elementProperties;for(const i of e.keys())this.hasOwnProperty(i)&&(t.set(i,this[i]),delete this[i]);t.size>0&&(this._$Ep=t)}createRenderRoot(){const i=this.shadowRoot??this.attachShadow(this.constructor.shadowRootOptions);return((i,s)=>{if(e)i.adoptedStyleSheets=s.map(t=>t instanceof CSSStyleSheet?t:t.styleSheet);else for(const e of s){const s=document.createElement("style"),a=t.litNonce;void 0!==a&&s.setAttribute("nonce",a),s.textContent=e.cssText,i.appendChild(s)}})(i,this.constructor.elementStyles),i}connectedCallback(){this.renderRoot??=this.createRenderRoot(),this.enableUpdating(!0),this._$EO?.forEach(t=>t.hostConnected?.())}enableUpdating(t){}disconnectedCallback(){this._$EO?.forEach(t=>t.hostDisconnected?.())}attributeChangedCallback(t,e,i){this._$AK(t,i)}_$ET(t,e){const i=this.constructor.elementProperties.get(t),s=this.constructor._$Eu(t,i);if(void 0!==s&&!0===i.reflect){const a=(void 0!==i.converter?.toAttribute?i.converter:f).toAttribute(e,i.type);this._$Em=t,null==a?this.removeAttribute(s):this.setAttribute(s,a),this._$Em=null}}_$AK(t,e){const i=this.constructor,s=i._$Eh.get(t);if(void 0!==s&&this._$Em!==s){const t=i.getPropertyOptions(s),a="function"==typeof t.converter?{fromAttribute:t.converter}:void 0!==t.converter?.fromAttribute?t.converter:f;this._$Em=s;const o=a.fromAttribute(e,t.type);this[s]=o??this._$Ej?.get(s)??o,this._$Em=null}}requestUpdate(t,e,i,s=!1,a){if(void 0!==t){const o=this.constructor;if(!1===s&&(a=this[t]),i??=o.getPropertyOptions(t),!((i.hasChanged??v)(a,e)||i.useDefault&&i.reflect&&a===this._$Ej?.get(t)&&!this.hasAttribute(o._$Eu(t,i))))return;this.C(t,e,i)}!1===this.isUpdatePending&&(this._$ES=this._$EP())}C(t,e,{useDefault:i,reflect:s,wrapped:a},o){i&&!(this._$Ej??=new Map).has(t)&&(this._$Ej.set(t,o??e??this[t]),!0!==a||void 0!==o)||(this._$AL.has(t)||(this.hasUpdated||i||(e=void 0),this._$AL.set(t,e)),!0===s&&this._$Em!==t&&(this._$Eq??=new Set).add(t))}async _$EP(){this.isUpdatePending=!0;try{await this._$ES}catch(t){Promise.reject(t)}const t=this.scheduleUpdate();return null!=t&&await t,!this.isUpdatePending}scheduleUpdate(){return this.performUpdate()}performUpdate(){if(!this.isUpdatePending)return;if(!this.hasUpdated){if(this.renderRoot??=this.createRenderRoot(),this._$Ep){for(const[t,e]of this._$Ep)this[t]=e;this._$Ep=void 0}const t=this.constructor.elementProperties;if(t.size>0)for(const[e,i]of t){const{wrapped:t}=i,s=this[e];!0!==t||this._$AL.has(e)||void 0===s||this.C(e,void 0,i,s)}}let t=!1;const e=this._$AL;try{t=this.shouldUpdate(e),t?(this.willUpdate(e),this._$EO?.forEach(t=>t.hostUpdate?.()),this.update(e)):this._$EM()}catch(e){throw t=!1,this._$EM(),e}t&&this._$AE(e)}willUpdate(t){}_$AE(t){this._$EO?.forEach(t=>t.hostUpdated?.()),this.hasUpdated||(this.hasUpdated=!0,this.firstUpdated(t)),this.updated(t)}_$EM(){this._$AL=new Map,this.isUpdatePending=!1}get updateComplete(){return this.getUpdateComplete()}getUpdateComplete(){return this._$ES}shouldUpdate(t){return!0}update(t){this._$Eq&&=this._$Eq.forEach(t=>this._$ET(t,this[t])),this._$EM()}updated(t){}firstUpdated(t){}};y.elementStyles=[],y.shadowRootOptions={mode:"open"},y[g("elementProperties")]=new Map,y[g("finalized")]=new Map,m?.({ReactiveElement:y}),(p.reactiveElementVersions??=[]).push("2.1.2");const $=globalThis,x=t=>t,w=$.trustedTypes,k=w?w.createPolicy("lit-html",{createHTML:t=>t}):void 0,S="$lit$",C=`lit$${Math.random().toFixed(9).slice(2)}$`,A="?"+C,z=`<${A}>`,D=document,M=()=>D.createComment(""),P=t=>null===t||"object"!=typeof t&&"function"!=typeof t,E=Array.isArray,R="[ \t\n\f\r]",T=/<(?:(!--|\/[^a-zA-Z])|(\/?[a-zA-Z][^>\s]*)|(\/?$))/g,O=/-->/g,U=/>/g,H=RegExp(`>|${R}(?:([^\\s"'>=/]+)(${R}*=${R}*(?:[^ \t\n\f\r"'\`<>=]|("|')|))|$)`,"g"),N=/'/g,q=/"/g,I=/^(?:script|style|textarea|title)$/i,L=t=>(e,...i)=>({_$litType$:t,strings:e,values:i}),F=L(1),j=L(2),W=Symbol.for("lit-noChange"),B=Symbol.for("lit-nothing"),K=new WeakMap,V=D.createTreeWalker(D,129);function Z(t,e){if(!E(t)||!t.hasOwnProperty("raw"))throw Error("invalid template strings array");return void 0!==k?k.createHTML(e):e}const Y=(t,e)=>{const i=t.length-1,s=[];let a,o=2===e?"":3===e?"":"")),s]};class X{constructor({strings:t,_$litType$:e},i){let s;this.parts=[];let a=0,o=0;const r=t.length-1,n=this.parts,[l,c]=Y(t,e);if(this.el=X.createElement(l,i),V.currentNode=this.el.content,2===e||3===e){const t=this.el.content.firstChild;t.replaceWith(...t.childNodes)}for(;null!==(s=V.nextNode())&&n.length0){s.textContent=w?w.emptyScript:"";for(let i=0;iE(t)||"function"==typeof t?.[Symbol.iterator])(t)?this.k(t):this._(t)}O(t){return this._$AA.parentNode.insertBefore(t,this._$AB)}T(t){this._$AH!==t&&(this._$AR(),this._$AH=this.O(t))}_(t){this._$AH!==B&&P(this._$AH)?this._$AA.nextSibling.data=t:this.T(D.createTextNode(t)),this._$AH=t}$(t){const{values:e,_$litType$:i}=t,s="number"==typeof i?this._$AC(t):(void 0===i.el&&(i.el=X.createElement(Z(i.h,i.h[0]),this.options)),i);if(this._$AH?._$AD===s)this._$AH.p(e);else{const t=new G(s,this),i=t.u(this.options);t.p(e),this.T(i),this._$AH=t}}_$AC(t){let e=K.get(t.strings);return void 0===e&&K.set(t.strings,e=new X(t)),e}k(t){E(this._$AH)||(this._$AH=[],this._$AR());const e=this._$AH;let i,s=0;for(const a of t)s===e.length?e.push(i=new Q(this.O(M()),this.O(M()),this,this.options)):i=e[s],i._$AI(a),s++;s2||""!==i[0]||""!==i[1]?(this._$AH=Array(i.length-1).fill(new String),this.strings=i):this._$AH=B}_$AI(t,e=this,i,s){const a=this.strings;let o=!1;if(void 0===a)t=J(this,t,e,0),o=!P(t)||t!==this._$AH&&t!==W,o&&(this._$AH=t);else{const s=t;let r,n;for(t=a[0],r=0;r{const s=i?.renderBefore??e;let a=s._$litPart$;if(void 0===a){const t=i?.renderBefore??null;s._$litPart$=a=new Q(e.insertBefore(M(),t),t,void 0,i??{})}return a._$AI(t),a})(e,this.renderRoot,this.renderOptions)}connectedCallback(){super.connectedCallback(),this._$Do?.setConnected(!0)}disconnectedCallback(){super.disconnectedCallback(),this._$Do?.setConnected(!1)}render(){return W}}nt._$litElement$=!0,nt.finalized=!0,rt.litElementHydrateSupport?.({LitElement:nt});const lt=rt.litElementPolyfillSupport;lt?.({LitElement:nt}),(rt.litElementVersions??=[]).push("4.2.2");const ct=new Set(["hacs","sun","backup","hassio","met","telegram_bot","mobile_app","systemmonitor","better_thermostat","adaptive_lighting","yandex_pogoda","upnp_serial_number"]),ht=[[/протечк/,"mdi:water-alert"],[/клапан/,"mdi:pipe-valve"],[/дым/,"mdi:smoke-detector"],[/термоголов/,"mdi:radiator"],[/температ/,"mdi:thermometer"],[/qingping|air monitor|молекул/,"mdi:air-filter"],[/штор/,"mdi:roller-shade"],[/розетк|plug/,"mdi:power-socket-de"],[/выключат|switch/,"mdi:light-switch"],[/лампа|лампочк|bulb|gx53|светильник|rgb/,"mdi:lightbulb"],[/камер|camera/,"mdi:cctv"],[/замок|ttlock|lock|sn609|sn9161/,"mdi:lock"],[/ворота|garage/,"mdi:garage-variant"],[/калитк|door|открыт/,"mdi:door"],[/счётчик|счетчик|kws|meter/,"mdi:meter-electric"],[/вводный автомат|breaker|wifimcbn/,"mdi:electric-switch"],[/myheat|котёл|котел|boiler|отоплен/,"mdi:water-boiler"],[/холодильник|fridge/,"mdi:fridge"],[/стиральн|washer/,"mdi:washing-machine"],[/сушилк|dryer/,"mdi:tumble-dryer"],[/пылесос|vacuum|dreame/,"mdi:robot-vacuum"],[/soundbar|колонк|станц/,"mdi:soundbar"],[/tv|телевизор|hyundaitv|mitv/,"mdi:television"],[/keenetic|роутер|router/,"mdi:router-wireless"],[/ибп|ups|kirpich/,"mdi:battery-charging-high"],[/slzb|координат|zigbee/,"mdi:zigbee"]];function dt(t,e){const i=((t||"")+" "+(e||"")).toLowerCase();for(const[t,e]of ht)if(t.test(i))return e;return"mdi:chip"}const pt=["light","switch","cover","valve","lock","climate","fan","media_player","camera","vacuum","humidifier","water_heater","alarm_control_panel","sensor","binary_sensor","event","button","number","select","update"];function _t(t){const e=Math.max(0,Math.min(120,(t-40)/140*120));return`hsl(${Math.round(e)}, 85%, 55%)`}function ut(t,e){return Math.round(t/e)*e}function mt(t){return t.length?Math.round(t.reduce((t,e)=>t+e,0)/t.length):null}function gt(t,e){if(e>t[2]/t[3]){const i=t[3],s=t[3]*e;return{x:t[0]-(s-t[2])/2,y:t[1],w:s,h:i}}const i=t[2],s=t[2]/e;return{x:t[0],y:t[1]-(s-t[3])/2,w:i,h:s}}function ft(t,e,i,s){if(t.length<2)return;const a=e.x+s,o=e.x+e.w-s,r=e.y+s,n=e.y+e.h-s;for(let e=0;e<60;e++){let e=!1;for(let s=0;s({eid:e,reg:t.entities[e],st:t.states[e]})).filter(t=>t.reg&&!t.reg.hidden),a=s.filter(t=>!t.reg.entity_category),o=a.length?a:s;if("mdi:thermometer"===i||"mdi:air-filter"===i){const e=o.find(e=>yt(t,e.eid));if(e)return e.eid}for(const t of pt){const e=o.find(e=>e.eid.split(".")[0]===t);if(e)return e.eid}return o[0]?.eid}function xt(t,e){const i=[];for(const s of e){const e=t.states[s];if(!e)continue;const a=(e.attributes?.unit_of_measurement||"").toLowerCase();if(/_(linkquality|lqi)$/.test(s)||"lqi"===a){const t=parseFloat(e.state);isNaN(t)||i.push(t);continue}const o=e.attributes?.linkquality??e.attributes?.lqi;if(null!=o){const t=parseFloat(o);isNaN(t)||i.push(t)}}return mt(i)}function wt(t,e){for(const i of e){if(!yt(t,i))continue;const e=t.states[i];if(!e)continue;const s=parseFloat(e.state);if(!isNaN(s))return Math.round(10*s)/10}return null}function kt(t,e){t.marker=e,e.name&&(t.name=e.name),e.icon&&(t.icon=e.icon),null!=e.model&&(t.model=e.model),t.link=e.link??null,t.description=e.description??null,t.pdfs=e.pdfs||[]}function St(t){const{hass:e,areaToSpace:i,markers:s,settings:a,excluded:o,showAll:r,firstSpaceId:n,loc:l}=t,c=!1!==a.group_lights,h=function(t,e){if(!e)return[];const i=[];for(const[e,s]of Object.entries(t.entities)){if(!e.startsWith("light.")||s.hidden)continue;let a=null;if("group"===s.platform)a=s.area_id||null;else{if(!s.device_id)continue;{const e=t.devices[s.device_id];if("Group"!==e?.model)continue;a=e.area_id||s.area_id||null}}if(!a)continue;const o=t.states[e];i.push({eid:e,name:s.name||o?.attributes?.friendly_name||e,area:a})}return i}(e,c),d=new Set(h.map(t=>t.area)),p=function(t){const e={};for(const[i,s]of Object.entries(t.entities))s?.device_id&&(e[s.device_id]=e[s.device_id]||[]).push(i);return e}(e),_=new Set;for(const t of s){const[e,i]=t.binding.split(":");"device"!==e&&"entity"!==e||!i||_.add(t.binding)}const u=(t,e)=>s.find(i=>i.binding===t+":"+e),m={},g=[];for(const t of Object.values(e.devices)){const s=t.area_id;if(!s||!i[s])continue;if("service"===t.entry_type)continue;if(_.has("device:"+t.id))continue;const a=u("device",t.id);if(a&&a.hidden)continue;const n=p[t.id]||[],h=bt(e,t,n);if(!r){if(o.has(h))continue;if("Group"===t.model)continue;if(/scene/i.test(t.model||""))continue;if(/bridge/i.test((t.model||"")+(t.name||"")))continue;if("myheat"===h&&t.via_device_id)continue}const f=(t.name_by_user||t.name||l("device.unnamed")).trim(),v=f+"|"+s;let b=dt(f,t.model);if(n.some(t=>t.startsWith("lock."))&&(b="mdi:lock"),!r&&c&&"mdi:lightbulb"===b&&d.has(s))continue;m[v]=(m[v]||0)+1;const y=m[v]>1?f+" "+m[v]:f,$={id:t.id,name:y,model:t.model||"",area:s,space:i[s],icon:b,entities:n,bindingKind:"device",bindingRef:t.id,pdfs:[]};$.primary=$t(e,n,b),"mdi:thermometer"!==b&&"mdi:air-filter"!==b||($.temp=wt(e,n)),g.push($)}for(const t of h)i[t.area]&&(_.has("entity:"+t.eid)||g.push({id:"lg_"+t.eid,name:t.name,model:l("device.light_group"),area:t.area,space:i[t.area],icon:"mdi:lightbulb-group",entities:[t.eid],primary:t.eid,bindingKind:"entity",bindingRef:t.eid,pdfs:[]}));for(const t of s){if(t.hidden)continue;const[s,a]=t.binding.split(":");if("device"===s){const s=e.devices[a],o=t.area||s?.area_id||"",r=o&&i[o]||t.space||n,c=s&&p[s.id]||[];let h=s?dt(s.name_by_user||s.name||"",s.model):"mdi:help-circle";c.some(t=>t.startsWith("lock."))&&(h="mdi:lock");const d={id:t.id,name:s?.name_by_user||s?.name||l("device.fallback"),model:s?.model||"",area:o,space:r,icon:h,entities:c,bindingKind:"device",bindingRef:a};d.primary=$t(e,c,h),"mdi:thermometer"!==h&&"mdi:air-filter"!==h||(d.temp=wt(e,c)),kt(d,t),g.push(d)}else if("entity"===s){const s=e.entities[a],o=t.area||s?.area_id||s?.device_id&&e.devices[s.device_id]?.area_id||"",r=o&&i[o]||t.space||n,l=e.states[a],c={id:t.id,name:s?.name||l?.attributes?.friendly_name||a,model:"",area:o,space:r,icon:"mdi:shape-outline",entities:[a],primary:a,bindingKind:"entity",bindingRef:a};kt(c,t),g.push(c)}else{const e=t.area||"",s=t.space||e&&i[e]||n,a={id:t.id,name:t.name||l("device.virtual"),model:t.model||"",area:e,space:s,icon:t.icon||"mdi:map-marker",entities:[],bindingKind:"virtual",virtual:!0};kt(a,t),g.push(a)}}return g}const Ct={"card.title":"House plan","count.devices":"{n} dev.","empty.no_spaces":"No spaces yet.","empty.add_first":"Add the first space and upload a floor plan.","empty.install":'Install the House Plan integration and add it in "Devices & services".',"btn.add_space":"Add space","btn.cancel":"Cancel","btn.save":"Save","btn.close":"Close","btn.delete":"Delete","btn.remove":"Remove","btn.edit":"Edit","btn.open_in_ha":"Open in HA","btn.reset":"Reset","btn.attach":"Attach…","btn.upload":"Upload…","btn.replace":"Replace…","btn.no_area":"No area","title.zoom_in":"Zoom in","title.zoom_out":"Zoom out","title.zoom_reset":"Reset zoom","title.add_device":"Add a device to the plan","title.show_all":"Show all area devices (no curation)","title.reset_layout":"Reset icon positions to auto layout","title.markup":"Room markup: grid, lines, outlines","title.configure_space":"Configure space","title.add_space":"Add space","title.markup_add":"Add a room: connect grid dots with lines until the outline closes","title.markup_erase":"Erase a line: click the line","title.markup_delroom":"Delete a room: click inside the room","title.no_area_room":"Decorative room without an HA area (e.g. a hallway)","title.choose_area":"Select a Home Assistant area","title.need_plan":"Upload a floor-plan image","markup.add":"Add","markup.erase":"Erase","markup.delete":"Delete","markup.hint_points":"points: {n} · Esc/Ctrl+Z — undo a dot · close the outline by clicking the first one","markup.hint_start":"click a grid dot to start the outline","tip.room":"room — open the area","tip.lqi":"average zigbee signal:","info.device_header":"Device on the plan","info.model":"Model","info.state":"State","info.link":"Link","info.manuals":"Manuals","info.none":"No additional information","marker.new_device":"New device","marker.name_label":"Name (shown on the plan)","marker.name_ph":"Name","marker.binding_label":"Bind to an HA device","marker.virtual_option":"Virtual device (no binding)","marker.search_ph":"Search device / group…","marker.nothing_found":"nothing found","marker.room_label":"Room","marker.room_override":" (override placement)","marker.room_choose":"— select a room —","marker.room_auto":"— by device area (auto) —","marker.icon_label":"Icon","marker.icon_ph":"mdi:… (empty = auto)","marker.model_label":"Model","marker.model_ph":"e.g. Aqara T&H","marker.link_label":"Link","marker.desc_label":"Description","marker.desc_ph":"Notes, specs…","marker.manuals_label":"Manuals (PDF etc.)","marker.sub_device":"device","marker.sub_z2m_group":" · Z2M group","marker.sub_group":"group","marker.sub_helper":"helper","space.new":"New space","space.header":"Space","space.title_label":"Title","space.title_ph":"e.g. Garage","space.plan_label":"Floor plan (background)","space.no_plan":"no plan image","space.plan_alt":"plan","room.new":"New room","room.name_label":"Display name","room.name_ph":"e.g. Terrace","room.area_label":"Home Assistant area (unassigned)","room.no_area_option":"— no area —","room.default_name":"Room","device.unnamed":"unnamed","device.light_group":"light group","device.fallback":"device","device.virtual":"virtual device","confirm.reset_layout":"Reset all icon positions to the auto layout?","confirm.delete_room":'Delete room "{name}"?',"confirm.remove_marker":'Remove "{name}" from the plan?',"confirm.delete_space":'Delete space "{title}" with all its rooms and markup?',"toast.pos_save_failed":"Failed to save position: {err}","toast.no_entity":"The device has no suitable entity","toast.markup_needs_server":"Markup is available after the config is moved to the server","toast.conflict":"Config was changed in another window — data refreshed, repeat your last action","toast.cfg_save_failed":"Failed to save config: {err}","toast.room_saved":"Room saved ({n}). Devices added: {added}. Outline the next one or exit markup.","toast.room_saved_no_area":"Room saved ({n}, no area). Outline the next one or exit markup.","toast.marker_needs_server":"Device editing is available after the config is moved to the server","toast.virtual_name_required":"Enter a name for the virtual device","toast.marker_saved":"Device saved","toast.marker_removed":"Device removed from the plan","toast.integration_missing":"The House Plan integration is not installed — management unavailable","toast.plan_formats":"Supported formats: SVG, PNG, JPG, WebP","toast.plan_required":"Upload a floor plan — it is required","toast.space_added_onboard":"Space added. Outline the rooms: click grid dots and close the contour.","toast.space_added":"Space added","toast.space_saved":"Space saved","toast.space_deleted":"Space deleted","toast.delete_failed":"Delete failed: {err}","toast.error":"Error: {err}","toast.file_failed":'File "{name}" was not uploaded: {err}',"toast.files_attached":"Files attached: {n}","err.unknown":"unknown error","err.code":"code {code}","err.too_large":"file larger than {mb} MB","err.bad_ext":"unsupported type (PDF/image expected)","err.unauthorized":"administrator rights required","editor.title":"Title","editor.default_floor":"Default space","editor.icon_size":"Icon size, % of plan width","editor.show_temperature":"Show temperature","editor.live_states":"Live states (on/off, open…)","editor.show_signal":"Show zigbee signal (LQI)","editor.language":"Interface language","editor.lang_auto":"Auto (HA profile)","editor.lang_en":"English","editor.lang_ru":"Русский"},At={en:Ct,ru:{"card.title":"План дома","count.devices":"{n} устр.","empty.no_spaces":"Пространств пока нет.","empty.add_first":"Добавьте первое пространство и загрузите план этажа.","empty.install":"Установите интеграцию House Plan и добавьте запись в «Устройства и службы».","btn.add_space":"Добавить пространство","btn.cancel":"Отмена","btn.save":"Сохранить","btn.close":"Закрыть","btn.delete":"Удалить","btn.remove":"Убрать","btn.edit":"Редактировать","btn.open_in_ha":"Открыть в HA","btn.reset":"Сброс","btn.attach":"Прикрепить…","btn.upload":"Загрузить…","btn.replace":"Заменить…","btn.no_area":"Без зоны","title.zoom_in":"Приблизить","title.zoom_out":"Отдалить","title.zoom_reset":"Сбросить масштаб","title.add_device":"Добавить устройство на план","title.show_all":"Показывать все устройства зоны (без курирования)","title.reset_layout":"Сбросить позиции значков к авто-раскладке","title.markup":"Разметка комнат: сетка, линии, контуры","title.configure_space":"Настроить пространство","title.add_space":"Добавить пространство","title.markup_add":"Добавить комнату: соединяйте точки сетки линиями до замкнутого контура","title.markup_erase":"Стереть линию: клик по линии","title.markup_delroom":"Удалить комнату: клик внутри комнаты","title.no_area_room":"Декоративная комната без привязки к зоне (например, холл)","title.choose_area":"Выберите зону Home Assistant","title.need_plan":"Загрузите подложку (план этажа)","markup.add":"Добавить","markup.erase":"Стереть","markup.delete":"Удалить","markup.hint_points":"точек: {n} · Esc/Ctrl+Z — убрать точку · замкните контур кликом по первой","markup.hint_start":"кликните точку сетки, чтобы начать контур","tip.room":"комната — открыть зону","tip.lqi":"средний сигнал zigbee:","info.device_header":"Устройство на плане","info.model":"Модель","info.state":"Состояние","info.link":"Ссылка","info.manuals":"Инструкции","info.none":"Нет дополнительной информации","marker.new_device":"Новое устройство","marker.name_label":"Имя (отображается на плане)","marker.name_ph":"Название","marker.binding_label":"Привязка к устройству HA","marker.virtual_option":"Виртуальное устройство (без привязки)","marker.search_ph":"Поиск устройства / группы…","marker.nothing_found":"ничего не найдено","marker.room_label":"Комната","marker.room_override":" (переопределить размещение)","marker.room_choose":"— выберите комнату —","marker.room_auto":"— по зоне устройства (авто) —","marker.icon_label":"Иконка","marker.icon_ph":"mdi:… (пусто = авто)","marker.model_label":"Модель","marker.model_ph":"напр. Aqara T&H","marker.link_label":"Ссылка","marker.desc_label":"Описание","marker.desc_ph":"Заметки, характеристики…","marker.manuals_label":"Инструкции (PDF и т.п.)","marker.sub_device":"устройство","marker.sub_z2m_group":" · Z2M-группа","marker.sub_group":"группа","marker.sub_helper":"хелпер","space.new":"Новое пространство","space.header":"Пространство","space.title_label":"Название","space.title_ph":"Например: Гараж","space.plan_label":"Подложка (план)","space.no_plan":"нет подложки","space.plan_alt":"план","room.new":"Новая комната","room.name_label":"Отображаемое имя","room.name_ph":"Например: Терраса","room.area_label":"Зона Home Assistant (свободные)","room.no_area_option":"— без зоны —","room.default_name":"Комната","device.unnamed":"без имени","device.light_group":"группа света","device.fallback":"устройство","device.virtual":"виртуальное устройство","confirm.reset_layout":"Сбросить позиции всех иконок к авто-раскладке?","confirm.delete_room":"Удалить комнату «{name}»?","confirm.remove_marker":"Убрать «{name}» с плана?","confirm.delete_space":"Удалить пространство «{title}» со всеми комнатами и разметкой?","toast.pos_save_failed":"Не удалось сохранить позицию: {err}","toast.no_entity":"У устройства нет подходящей сущности","toast.markup_needs_server":"Разметка доступна после переноса конфига на сервер","toast.conflict":"Конфиг изменён в другом окне — данные обновлены, повторите последнее действие","toast.cfg_save_failed":"Не удалось сохранить конфиг: {err}","toast.room_saved":"Комната сохранена ({n}). Устройств добавлено: {added}. Обведите следующую или выйдите из разметки.","toast.room_saved_no_area":"Комната сохранена ({n}, без зоны). Обведите следующую или выйдите из разметки.","toast.marker_needs_server":"Редактирование устройств доступно после переноса конфига на сервер","toast.virtual_name_required":"Укажите имя виртуального устройства","toast.marker_saved":"Устройство сохранено","toast.marker_removed":"Устройство убрано с плана","toast.integration_missing":"Интеграция House Plan не установлена — управление недоступно","toast.plan_formats":"Поддерживаются SVG, PNG, JPG, WebP","toast.plan_required":"Загрузите подложку — план этажа обязателен","toast.space_added_onboard":"Пространство добавлено. Обведите комнаты: кликайте по точкам сетки и замкните контур.","toast.space_added":"Пространство добавлено","toast.space_saved":"Пространство сохранено","toast.space_deleted":"Пространство удалено","toast.delete_failed":"Ошибка удаления: {err}","toast.error":"Ошибка: {err}","toast.file_failed":"Файл «{name}» не загружен: {err}","toast.files_attached":"Прикреплено файлов: {n}","err.unknown":"неизвестная ошибка","err.code":"код {code}","err.too_large":"файл больше {mb} МБ","err.bad_ext":"недопустимый тип (нужен PDF/изображение)","err.unauthorized":"нужны права администратора","editor.title":"Заголовок","editor.default_floor":"Пространство по умолчанию","editor.icon_size":"Размер иконок, % ширины плана","editor.show_temperature":"Показывать температуру","editor.live_states":"Живые состояния (вкл/выкл, открыто…)","editor.show_signal":"Показывать сигнал zigbee (LQI)","editor.language":"Язык интерфейса","editor.lang_auto":"Авто (профиль HA)","editor.lang_en":"English","editor.lang_ru":"Русский"}};function zt(t,e){if("ru"===e||"en"===e)return e;return(t?.locale?.language||t?.language||"en").toLowerCase().startsWith("ru")?"ru":"en"}function Dt(t,e,i){let s=At[t][e]??Ct[e]??e;if(i)for(const[t,e]of Object.entries(i))s=s.replace("{"+t+"}",String(e));return s}class Mt extends nt{constructor(){super(...arguments),this._spaces=null,this._spacesLoading=!1}setConfig(t){this._config=t}async _loadSpaces(){if(!this._spaces&&!this._spacesLoading&&this.hass){this._spacesLoading=!0;try{const t=await this.hass.callWS({type:"houseplan/config/get"});this._spaces=(t?.config?.spaces||[]).map(t=>({value:t.id,label:t.title||t.id}))}catch{this._spaces=[]}finally{this._spacesLoading=!1}}}get _lang(){return zt(this.hass,this._config?.language)}get _schema(){const t=this._spaces||[],e=this._lang;return[{name:"title",selector:{text:{}}},t.length?{name:"default_floor",selector:{select:{mode:"dropdown",options:t}}}:{name:"default_floor",selector:{text:{}}},{name:"language",selector:{select:{mode:"dropdown",options:[{value:"",label:Dt(e,"editor.lang_auto")},{value:"en",label:Dt(e,"editor.lang_en")},{value:"ru",label:Dt(e,"editor.lang_ru")}]}}},{name:"icon_size",selector:{number:{min:1,max:6,step:.1,mode:"box"}}},{name:"show_temperature",selector:{boolean:{}}},{name:"live_states",selector:{boolean:{}}},{name:"show_signal",selector:{boolean:{}}}]}render(){if(!this.hass||!this._config)return B;this._loadSpaces();const t=this._lang,e={title:Dt(t,"editor.title"),default_floor:Dt(t,"editor.default_floor"),language:Dt(t,"editor.language"),icon_size:Dt(t,"editor.icon_size"),show_temperature:Dt(t,"editor.show_temperature"),live_states:Dt(t,"editor.live_states"),show_signal:Dt(t,"editor.show_signal")};return F`Ct[t.name]||t.name}
+ .computeLabel=${t=>e[t.name]||t.name}
@value-changed=${this._valueChanged}
- > `):B}_valueChanged(t){const e={...this._config,...t.detail.value},i=new Event("config-changed",{bubbles:!0,composed:!0});i.detail={config:e},this.dispatchEvent(i)}}At.properties={hass:{attribute:!1},_config:{state:!0},_spaces:{state:!0}},customElements.get("houseplan-card-editor")||customElements.define("houseplan-card-editor",At);const zt=((t,...e)=>{const s=1===t.length?t[0]:e.reduce((e,i,s)=>e+(t=>{if(!0===t._$cssResult$)return t.cssText;if("number"==typeof t)return t;throw Error("Value passed to 'css' function must be a 'css' function result: "+t+". Use 'unsafeCSS' to pass non-literal values, but take care to ensure page security.")})(i)+t[s+1],t[0]);return new a(s,t,i)})`
+ > `}_valueChanged(t){const e={...this._config,...t.detail.value},i=new Event("config-changed",{bubbles:!0,composed:!0});i.detail={config:e},this.dispatchEvent(i)}}Mt.properties={hass:{attribute:!1},_config:{state:!0},_spaces:{state:!0}},customElements.get("houseplan-card-editor")||customElements.define("houseplan-card-editor",Mt);const Pt=((t,...e)=>{const s=1===t.length?t[0]:e.reduce((e,i,s)=>e+(t=>{if(!0===t._$cssResult$)return t.cssText;if("number"==typeof t)return t;throw Error("Value passed to 'css' function must be a 'css' function result: "+t+". Use 'unsafeCSS' to pass non-literal values, but take care to ensure page security.")})(i)+t[s+1],t[0]);return new a(s,t,i)})`
:host {
--hp-bg: var(--card-background-color, #16212e);
--hp-line: var(--divider-color, #2b3d4f);
@@ -15,7 +15,7 @@ const t=globalThis,e=t.ShadowRoot&&(void 0===t.ShadyCSS||t.ShadyCSS.nativeShadow
--hp-open: #ff9f43;
}
ha-card {
- overflow: visible; /* overflow:hidden ломает position:sticky у шапки */
+ overflow: visible; /* overflow:hidden breaks position:sticky on the header */
}
.empty {
padding: 40px 24px;
@@ -142,7 +142,7 @@ const t=globalThis,e=t.ShadowRoot&&(void 0===t.ShadyCSS||t.ShadyCSS.nativeShadow
width: 100%;
container-type: inline-size;
overflow: hidden;
- touch-action: none; /* свои жесты pinch/pan */
+ touch-action: none; /* custom pinch/pan gestures */
background: var(--ha-card-background, var(--card-background-color, #111));
}
.zoomwrap {
@@ -223,7 +223,7 @@ const t=globalThis,e=t.ShadowRoot&&(void 0===t.ShadyCSS||t.ShadyCSS.nativeShadow
pointer-events: none;
}
.stage.markup .devlayer {
- display: none; /* в разметке иконки не мешают */
+ display: none; /* in markup mode icons must not get in the way */
}
.room.outlined {
stroke: rgba(62, 166, 255, 0.55);
@@ -727,63 +727,63 @@ const t=globalThis,e=t.ShadowRoot&&(void 0===t.ShadyCSS||t.ShadyCSS.nativeShadow
z-index: 120;
max-width: 90vw;
}
- `,Mt="houseplan_card_layout_v1",Dt="houseplan_card_cfg_v1",Pt="houseplan_card_zoom_v1",Et=1e3,Rt=(t,e,i)=>{const s=new Event(e,{bubbles:!0,composed:!0});s.detail=i??{},t.dispatchEvent(s)},Tt=(t,e)=>{let i;return(...s)=>{clearTimeout(i),i=window.setTimeout(()=>t(...s),e)}};class Ot extends rt{constructor(){super(...arguments),this._space="f1",this._layout={},this._serverStorage=!1,this._loadOk=!1,this._loading=!1,this._loadTries=0,this._serverCfg=null,this._cfgRev=0,this._unsubCfg=null,this._devices=[],this._regSignature="",this._defPos={},this._tip=null,this._selId=null,this._toast="",this._markup=!1,this._tool="draw",this._path=[],this._pathSegs=[],this._cursorPt=null,this._areaSel="",this._nameSel="",this._roomDialog=!1,this._zoom=1,this._view=null,this._zoomBySpace={},this._pointers=new Map,this._panStart=null,this._pinchStart=null,this._suppressClick=!1,this._onboardingShown=!1,this._infoCard=null,this._markerDialog=null,this._spaceDialog=null,this._keyHandler=t=>this._onKey(t),this._drag=null,this._dirtyPos=new Set,this._persistLayout=Tt(()=>{if(this._serverStorage){const t=[...this._dirtyPos];this._dirtyPos.clear();for(const e of t){const t=this._layout[e];t&&this.hass.callWS({type:"houseplan/layout/update",device_id:e,pos:t}).catch(t=>this._showToast("Не удалось сохранить позицию: "+(t?.message||t)))}this._cacheSnapshot()}else localStorage.setItem(Mt,JSON.stringify(this._layout))},600),this._saveConfig=Tt(()=>{this._serverCfg&&this.hass.callWS({type:"houseplan/config/set",config:this._serverCfg,expected_rev:this._cfgRev}).then(t=>{this._cfgRev=t?.rev??this._cfgRev+1}).catch(t=>{"conflict"===t?.code?(this._showToast("Конфиг изменён в другом окне — данные обновлены, повторите последнее действие"),this._cancelPath(),this._reloadConfigOnly()):this._showToast("Не удалось сохранить конфиг: "+(t?.message||t))})},500)}connectedCallback(){super.connectedCallback(),window.addEventListener("keydown",this._keyHandler)}disconnectedCallback(){window.removeEventListener("keydown",this._keyHandler),this._roViewport?.disconnect(),this._roViewport=void 0,this._unsubCfg&&(this._unsubCfg(),this._unsubCfg=null),super.disconnectedCallback()}_onKey(t){if("Escape"===t.key){if(this._infoCard)return void(this._infoCard=null);if(this._markerDialog)return void(this._markerDialog=null)}if(!this._markup)return;return"Escape"===t.key||(t.ctrlKey||t.metaKey)&&"z"===t.key.toLowerCase()?this._roomDialog?(t.preventDefault(),void this._roomDialogCancel()):void("draw"===this._tool&&this._path.length&&(t.preventDefault(),this._undoPoint())):void 0}_undoPoint(){if(!this._path.length)return;if(1===this._path.length)return this._path=[],void(this._pathSegs=[]);const t=this._pathSegs[this._pathSegs.length-1];this._pathSegs=this._pathSegs.slice(0,-1),t&&this._removeSegmentByKey(t),this._path=this._path.slice(0,-1)}_removeSegmentByKey(t){const e=this._curSpaceCfg;if(!e?.segments)return;const i=this._segments.findIndex(e=>this._segKey([e[0],e[1]],[e[2],e[3]])===t);i>=0&&(e.segments.splice(i,1),this._saveConfig())}static getConfigElement(){return document.createElement("houseplan-card-editor")}static getStubConfig(){return{type:"custom:houseplan-card",title:"План дома"}}setConfig(t){this._config={icon_size:2.5,show_temperature:!0,live_states:!0,show_signal:!0,...t},t.default_floor&&(this._space=t.default_floor);try{this._zoomBySpace=JSON.parse(localStorage.getItem(Pt)||"{}")||{}}catch{this._zoomBySpace={}}try{const e=JSON.parse(localStorage.getItem(Dt)||"null");e&&e.config&&Array.isArray(e.config.spaces)&&(this._serverCfg=e.config,this._cfgRev=e.rev||0,this._layout=e.layout||{},this._serverStorage=!0,t.default_floor?this._space=t.default_floor:this._model.find(t=>t.id===this._space)||(this._space=this._model[0]?.id||this._space))}catch{}}_cacheSnapshot(){if(this._serverCfg)try{localStorage.setItem(Dt,JSON.stringify({config:this._serverCfg,rev:this._cfgRev,layout:this._layout}))}catch{}}getCardSize(){return 12}get _norm(){return!(!this._serverCfg||!this._serverCfg.spaces.length)}get _model(){return this._serverCfg?this._serverCfg.spaces.map(t=>{const e=Et/t.aspect;return{id:t.id,title:t.title,vb:[t.view_box[0]*Et,t.view_box[1]*e,t.view_box[2]*Et,t.view_box[3]*e],bg:t.plan_url?{href:t.plan_url,x:0,y:0,w:Et,h:e}:null,rooms:t.rooms.map(t=>({id:t.id,name:t.name,area:t.area??null,x:null!=t.x?t.x*Et:void 0,y:null!=t.y?t.y*e:void 0,w:null!=t.w?t.w*Et:void 0,h:null!=t.h?t.h*e:void 0,poly:t.poly?t.poly.map(t=>[t[0]*Et,t[1]*e]):void 0}))}}):[]}_spaceModel(t){const e=this._model;return e.find(e=>e.id===(t??this._space))||e[0]}get _areaToSpace(){const t={};for(const e of this._model)for(const i of e.rooms)i.area&&(t[i.area]={space:e.id,room:i});return t}get _settings(){return this._serverCfg?.settings||{}}get _showAll(){return!!this._settings.show_all}_toggleShowAll(){this._serverCfg&&(this._serverCfg={...this._serverCfg,settings:{...this._serverCfg.settings,show_all:!this._showAll}},this._regSignature="",this._maybeRebuildDevices(),this._saveConfig(),this.requestUpdate())}get _excluded(){const t=this._settings.exclude_integrations;return t?new Set(t):ct}willUpdate(t){t.has("hass")&&this.hass&&(!this._loadOk&&!this._loading&&this._loadTries<8&&this._loadFromServer(),this._maybeRebuildDevices())}updated(){const t=this._stageEl;t&&!this._roViewport&&(this._roViewport=new ResizeObserver(()=>this._refitView()),this._roViewport.observe(t)),t&&!this._view&&this._refitView(),this._serverStorage&&this._loadOk&&0===this._model.length&&!this._spaceDialog&&!this._onboardingShown&&(this._onboardingShown=!0,this._openSpaceDialog("create"))}async _loadFromServer(){this._loading=!0,this._loadTries++;try{const[t,e]=await Promise.all([this.hass.callWS({type:"houseplan/config/get"}),this.hass.callWS({type:"houseplan/layout/get"})]);this._loadOk=!0,this._serverStorage=!0;const i=t?.config;this._serverCfg=i&&Array.isArray(i.spaces)?i:null,this._cfgRev=t?.rev||0,this._layout=e?.layout||{},this._unsubCfg||(this._unsubCfg=await this.hass.connection.subscribeEvents(t=>{(t?.data?.rev??-1)!==this._cfgRev&&this._reloadConfigOnly()},"houseplan_config_updated")),this._norm&&!this._model.find(t=>t.id===this._space)&&(this._space=this._model[0]?.id||this._space),this._cacheSnapshot(),this._restoreZoom()}catch(t){if(this._loadTries>=8){this._serverStorage=!1,this._serverCfg=null;try{this._layout=JSON.parse(localStorage.getItem(Mt)||"{}")||{}}catch{this._layout={}}}}finally{this._loading=!1}this._regSignature="",this.requestUpdate()}async _reloadConfigOnly(){try{const t=await this.hass.callWS({type:"houseplan/config/get"}),e=t?.config;this._serverCfg=e&&Array.isArray(e.spaces)?e:null,this._cfgRev=t?.rev||0,this._cacheSnapshot(),this._regSignature="",this._maybeRebuildDevices(),this.requestUpdate()}catch{}}_maybeRebuildDevices(){const t=this.hass;if(!t?.devices||!t?.entities||!t?.areas)return;const e=Object.keys(t.devices).length+":"+Object.keys(t.entities).length+":"+Object.keys(t.areas).length+":"+(this._norm?"n":"l");e===this._regSignature&&this._devices.length||(this._regSignature=e,this._devices=St({hass:t,areaToSpace:Object.fromEntries(Object.entries(this._areaToSpace).map(([t,e])=>[t,e.space])),markers:this._markers,settings:this._settings,excluded:this._excluded,showAll:this._showAll,firstSpaceId:this._model[0]?.id||""}),this._defPos=this._defaultPositions())}get _markers(){return this._serverCfg?.markers||[]}_roomLqi(t){if(!t)return null;const e=[];for(const i of this._devices){if(i.area!==t||i.virtual)continue;const s=$t(this.hass,i.entities);null!=s&&e.push(s)}return gt(e)}_roomBounds(t){if(t.poly&&t.poly.length){const e=t.poly.map(t=>t[0]),i=t.poly.map(t=>t[1]),s=Math.min(...e),a=Math.min(...i);return{x:s,y:a,w:Math.max(...e)-s,h:Math.max(...i)-a}}return{x:t.x??0,y:t.y??0,w:t.w??0,h:t.h??0}}_defaultPositions(){const t={},e=(this._config?.icon_size??2.5)/100*Et*1.3;for(const i of this._model)for(const s of i.rooms){if(!s.area)continue;const a=this._devices.filter(t=>t.area===s.area&&t.space===i.id);if(!a.length)continue;const o=this._roomBounds(s),n=.1*Math.min(o.w,o.h),r=o.w-2*n,l=o.h-2*n,c=Math.max(1,Math.round(Math.sqrt(a.length*r/Math.max(l,1)))),h=Math.ceil(a.length/c),d=r/c,p=l/Math.max(h,1),u=a.map((t,e)=>({x:o.x+n+d*(e%c+.5),y:o.y+n+p*(Math.floor(e/c)+.5)}));ft(u,o,e,.5*n),a.forEach((e,i)=>t[e.id]=u[i])}return t}_pos(t){const e=this._spaceModel(t.space),i=this._layout[t.id];if(i)if(this._norm){if(i.s===t.space){const e=this._serverCfg.spaces.find(e=>e.id===t.space)?.aspect||1;return{x:i.x*Et,y:i.y*(Et/e)}}}else if(void 0===i.s)return{x:i.x,y:i.y};if(this._defPos[t.id])return this._defPos[t.id];const s=e.vb;return{x:s[0]+s[2]/2,y:s[1]+s[3]/2}}_savePos(t,e,i){if(this._norm){const s=this._gridPitch,a=Math.round(e/s)*s,o=Math.round(i/s)*s,n=this._serverCfg.spaces.find(e=>e.id===t.space)?.aspect||1;this._layout={...this._layout,[t.id]:{s:t.space,x:a/Et,y:o/(Et/n)}}}else this._layout={...this._layout,[t.id]:{x:Math.round(e),y:Math.round(i)}};this._dirtyPos.add(t.id),this._persistLayout()}_stateClass(t){if(!this._config?.live_states)return"";const e=t.primary?this.hass.states[t.primary]:void 0;if(!e)return"";if("unavailable"===e.state)return"unavail";const i=e.entity_id.split(".")[0];if(["light","switch","fan","humidifier"].includes(i))return"on"===e.state?"on":"";if("cover"===i||"valve"===i)return["open","opening"].includes(e.state)?"open":"";if("lock"===i)return["unlocked","open"].includes(e.state)?"open":"";if("binary_sensor"===i){const t=e.attributes?.device_class;if(["door","window","garage_door","opening","gas","smoke","moisture","problem"].includes(t))return"on"===e.state?"open":""}return"media_player"===i?["playing","on"].includes(e.state)?"on":"":"vacuum"===i&&["cleaning","returning"].includes(e.state)?"on":""}_liveTemp(t){return this._config?.show_temperature?"mdi:thermometer"!==t.icon&&"mdi:air-filter"!==t.icon?null:wt(this.hass,t.entities):null}_openMoreInfo(t){t?Rt(this,"hass-more-info",{entityId:t}):this._showToast("У устройства нет подходящей сущности")}_clickDevice(t,e){t.stopPropagation(),this._drag?.moved||this._suppressClick||this._markup||(this._infoCard=e)}get _stageEl(){return this.renderRoot.querySelector(".stage")}_stageAspect(){const t=this._stageEl,e=this._spaceModel().vb;return t&&t.clientHeight?t.clientWidth/t.clientHeight:e[2]/e[3]}_viewOr(t){return this._view&&this._view.w?this._view:mt(t,this._stageAspect())}_screenToVb(t,e){const i=this._stageEl,s=this._viewOr(this._spaceModel().vb),a=i?.clientWidth||1,o=i?.clientHeight||1;return[s.x+t/a*s.w,s.y+e/o*s.h]}_clampView(t,e){return{w:t.w,h:t.h,x:Math.max(e.x,Math.min(e.x+e.w-t.w,t.x)),y:Math.max(e.y,Math.min(e.y+e.h-t.h,t.y))}}_applyView(t,e,i){const s=this._spaceModel().vb,a=mt(s,this._stageAspect()),o=Math.min(8,Math.max(1,t)),n=a.w/o,r=a.h/o,l=this._viewOr(s),c=e??l.x+l.w/2,h=i??l.y+l.h/2;this._zoom=o,this._view=this._clampView({x:c-n/2,y:h-r/2,w:n,h:r},a)}_refitView(){if(!this._stageEl)return;const t=this._view;this._applyView(this._zoom,t?t.x+t.w/2:void 0,t?t.y+t.h/2:void 0),this.requestUpdate()}_zoomAt(t,e,i){const s=this._stageEl;if(!s)return;const a=mt(this._spaceModel().vb,this._stageAspect()),o=Math.min(8,Math.max(1,i)),n=s.clientWidth,r=s.clientHeight,l=this._screenToVb(t,e),c=a.w/o,h=a.h/o;this._zoom=o,this._view=this._clampView({x:l[0]-t/n*c,y:l[1]-e/r*h,w:c,h:h},a)}_onWheel(t){const e=this._stageEl;if(!e)return;t.preventDefault();const i=e.getBoundingClientRect(),s=t.deltaY<0?1.15:1/1.15;this._zoomAt(t.clientX-i.left,t.clientY-i.top,this._zoom*s),this._saveZoom()}_stepZoom(t){const e=this._stageEl;e&&(this._zoomAt(e.clientWidth/2,e.clientHeight/2,this._zoom*(t>0?1.4:1/1.4)),this._saveZoom())}_resetZoom(){const t=this._spaceModel().vb;this._zoom=1,this._view=mt(t,this._stageAspect()),this._saveZoom()}_saveZoom(){this._zoomBySpace={...this._zoomBySpace,[this._space]:this._zoom};try{localStorage.setItem(Pt,JSON.stringify(this._zoomBySpace))}catch{}}_restoreZoom(){const t=this._zoomBySpace[this._space]||1;this._zoom=t,this._view=null,requestAnimationFrame(()=>{if(!this._stageEl)return;const e=this._spaceModel().vb;this._applyView(t,e[0]+e[2]/2,e[1]+e[3]/2),this.requestUpdate()})}_stagePointerDown(t){if(this._drag||this._markup)return;if(t.target.closest(".dev"))return;this._pointers.set(t.pointerId,{x:t.clientX,y:t.clientY});const e=this._viewOr(this._spaceModel().vb);if(1===this._pointers.size)this._panStart={sx:t.clientX,sy:t.clientY,vx:e.x,vy:e.y},this._suppressClick=!1;else if(2===this._pointers.size){const t=[...this._pointers.values()],e=Math.hypot(t[0].x-t[1].x,t[0].y-t[1].y);this._pinchStart={dist:e,zoom:this._zoom},this._panStart=null}}_stagePointerMove(t){if(this._pointers.has(t.pointerId)){if(this._pointers.set(t.pointerId,{x:t.clientX,y:t.clientY}),this._pinchStart&&this._pointers.size>=2){const t=[...this._pointers.values()],e=Math.hypot(t[0].x-t[1].x,t[0].y-t[1].y)/(this._pinchStart.dist||1),i=this._stageEl.getBoundingClientRect(),s=(t[0].x+t[1].x)/2-i.left,a=(t[0].y+t[1].y)/2-i.top;this._zoomAt(s,a,this._pinchStart.zoom*e),this._suppressClick=!0,this._saveZoom()}else if(this._panStart){const e=t.clientX-this._panStart.sx,i=t.clientY-this._panStart.sy;if(Math.abs(e)+Math.abs(i)>4&&(this._suppressClick=!0),this._zoom>1&&this._view){const t=this._stageEl,s=this._view,a=mt(this._spaceModel().vb,this._stageAspect());this._view=this._clampView({x:this._panStart.vx-e/t.clientWidth*s.w,y:this._panStart.vy-i/t.clientHeight*s.h,w:s.w,h:s.h},a)}}}else this._markupMove(t)}_stagePointerUp(t){this._pointers.delete(t.pointerId),this._pointers.size<2&&(this._pinchStart=null),0===this._pointers.size&&(this._panStart=null,setTimeout(()=>this._suppressClick=!1,0))}_clickRoom(t){var e;!this._suppressClick&&t.area&&(e="/config/areas/area/"+t.area,history.pushState(null,"",e),Rt(window,"location-changed",{replace:!1}))}_pointerDown(t,e){if(this._markup)return;t.preventDefault();const i=this._pos(e);this._drag={id:e.id,sx:t.clientX,sy:t.clientY,ox:i.x,oy:i.y,moved:!1},t.target.setPointerCapture(t.pointerId),this._tip=null}_pointerMove(t,e){if(!this._drag||this._drag.id!==e.id)return;const i=this.renderRoot.querySelector(".stage");if(!i)return;const s=this._spaceModel().vb,a=i.getBoundingClientRect(),o=this._viewOr(s),n=(t.clientX-this._drag.sx)/a.width*o.w,r=(t.clientY-this._drag.sy)/a.height*o.h;Math.abs(t.clientX-this._drag.sx)+Math.abs(t.clientY-this._drag.sy)>3&&(this._drag.moved=!0);const l=.008*Math.min(s[2],s[3]),c=Math.max(s[0]+l,Math.min(s[0]+s[2]-l,this._drag.ox+n)),h=Math.max(s[1]+l,Math.min(s[1]+s[3]-l,this._drag.oy+r));this._savePos(e,c,h)}_pointerUp(t,e){if(!this._drag||this._drag.id!==e.id)return;const i=this._drag.moved;this._drag=i?this._drag:null,i&&(this._selId=e.id,window.setTimeout(()=>this._drag=null,0))}_resetLayout(){confirm("Сбросить позиции всех иконок к авто-раскладке?")&&(this._layout={},this._persistLayout())}_showToast(t){this._toast=t,clearTimeout(this._toastTimer),this._toastTimer=window.setTimeout(()=>{this._toast=""},3500)}_showTip(t,e,i,s){this._drag||(this._tip={x:t.clientX,y:t.clientY,title:e,meta:i,lqi:s})}get _gridPitch(){return Et/240}get _curSpaceCfg(){return this._serverCfg?.spaces.find(t=>t.id===this._space)}get _spaceH(){const t=this._curSpaceCfg;return t?Et/t.aspect:Et}get _segments(){const t=this._curSpaceCfg,e=this._spaceH;return(t?.segments||[]).map(t=>[t[0]*Et,t[1]*e,t[2]*Et,t[3]*e])}_toggleMarkup(){this._norm?(this._markup=!this._markup,this._path=[],this._cursorPt=null,this._tool="draw"):this._showToast("Разметка доступна после переноса конфига на сервер (режим правки → «На сервер»)")}_svgPoint(t){const e=this.renderRoot.querySelector(".stage").getBoundingClientRect();return this._screenToVb(t.clientX-e.left,t.clientY-e.top)}_snap(t){const e=this._gridPitch;return[_t(t[0],e),_t(t[1],e)]}_samePt(t,e){return function(t,e,i=.001){return Math.abs(t[0]-e[0])this._segKey([t[0],t[1]],[t[2],t[3]])===a);return!o&&(i.segments=i.segments||[],i.segments.push([t[0]/Et,t[1]/s,e[0]/Et,e[1]/s]),this._saveConfig(),!0)}_distToSeg(t,e){const[i,s]=t,[a,o,n,r]=e,l=n-a,c=r-o;let h=((i-a)*l+(s-o)*c)/(l*l+c*c||1);h=Math.max(0,Math.min(1,h));const d=a+h*l,p=o+h*c;return Math.hypot(i-d,s-p)}_pointInRoom(t,e){return e.poly?function(t,e){let i=!1;for(let s=0,a=e.length-1;st[1]!=l>t[1]&&t[0]<(r-o)*(t[1]-n)/(l-n)+o&&(i=!i)}return i}(t,e.poly):null!=e.x&&t[0]>=e.x&&t[0]<=e.x+e.w&&t[1]>=e.y&&t[1]<=e.y+e.h}_markupClick(t){if(!this._markup)return;const e=this._svgPoint(t);if("erase"===this._tool){const t=this._curSpaceCfg;if(!t?.segments?.length)return;const i=this._segments;let s=-1,a=.5*this._gridPitch;return i.forEach((t,i)=>{const o=this._distToSeg(e,t);o=0&&(t.segments.splice(s,1),this._saveConfig(),this.requestUpdate()))}if("delroom"===this._tool){const t=[...this._spaceModel().rooms].reverse().find(t=>this._pointInRoom(e,t));if(!t)return;if(!confirm(`Удалить комнату «${t.name}»?`))return;const i=this._curSpaceCfg;return i.rooms=i.rooms.filter(e=>e.id!==t.id),this._saveConfig(),this._regSignature="",this._maybeRebuildDevices(),void this.requestUpdate()}const i=this._snap(e);if(!this._path.length)return this._path=[i],void(this._pathSegs=[]);const s=this._path[this._path.length-1];if(this._samePt(i,s))return;const a=this._addSegment(s,i);this._pathSegs=[...this._pathSegs,a?this._segKey(s,i):null],this._path=[...this._path,i],this._path.length>=4&&this._samePt(i,this._path[0])&&(this._cursorPt=null,this._nameSel="",this._areaSel="",this._roomDialog=!0)}get _contourClosed(){return this._path.length>=4&&this._samePt(this._path[0],this._path[this._path.length-1])}_markupMove(t){this._markup&&"draw"===this._tool&&this._path.length&&!this._contourClosed&&(this._cursorPt=this._snap(this._svgPoint(t)))}_saveRoom(){this._areaSel&&this._commitRoom()}_saveRoomNoArea(){this._nameSel.trim()&&(this._areaSel="",this._commitRoom())}_commitRoom(){if(!this._contourClosed)return;const t=this._curSpaceCfg;if(!t)return;const e=this._spaceH,i=this._path.slice(0,-1),s=this._areaSel?this.hass.areas[this._areaSel]?.name:"";t.rooms.push({id:"r"+Date.now().toString(36),name:this._nameSel||s||"Комната",area:this._areaSel||null,poly:i.map(t=>[t[0]/Et,t[1]/e])}),this._saveConfig(),this._path=[],this._pathSegs=[];const a=this._areaSel;this._areaSel="",this._nameSel="",this._roomDialog=!1,this._regSignature="",this._maybeRebuildDevices();let o=0;if(a){const t=this._serverCfg?.spaces.find(t=>t.id===this._space)?.aspect||1,e=Et/t,i={...this._layout};for(const t of this._devices){if(t.area!==a||t.space!==this._space)continue;if(o++,this._layout[t.id])continue;const s=this._defPos[t.id];s&&(i[t.id]={s:this._space,x:s.x/Et,y:s.y/e},this._dirtyPos.add(t.id))}this._layout=i,this._persistLayout()}const n=this._model.find(t=>t.id===this._space)?.rooms.length||0;this._showToast(a?`Комната сохранена (${n}). Устройств добавлено: ${o}. Обведите следующую или выйдите из разметки.`:`Комната сохранена (${n}, без зоны). Обведите следующую или выйдите из разметки.`)}_cancelPath(){this._path=[],this._pathSegs=[],this._cursorPt=null,this._roomDialog=!1}_roomDialogCancel(){this._roomDialog=!1,this._undoPoint()}get _freeAreas(){const t=new Set;for(const e of this._serverCfg?.spaces||[])for(const i of e.rooms||[])i.area&&t.add(i.area);return Object.values(this.hass?.areas||{}).filter(e=>!t.has(e.area_id)).sort((t,e)=>(t.name||"").localeCompare(e.name||""))}_openMarkerDialog(t){this._norm?this._markerDialog=t?{devId:t.id,name:t.name,binding:"virtual"===t.bindingKind?"virtual":t.bindingKind+":"+t.bindingRef,bindingFilter:"",icon:t.marker?.icon||"",model:t.model||"",link:t.link||"",description:t.description||"",pdfs:[...t.pdfs||[]],room:t.space&&t.area?t.space+"#"+t.area:"",busy:!1}:{name:"",binding:"virtual",bindingFilter:"",icon:"",model:"",link:"",description:"",pdfs:[],room:"",busy:!1}:this._showToast("Редактирование устройств доступно после переноса конфига на сервер")}_bindingCandidates(){const t=this.hass,e=new Set;for(const t of this._devices)t.id!==this._markerDialog?.devId&&("device"===t.bindingKind&&t.bindingRef&&e.add("device:"+t.bindingRef),"entity"===t.bindingKind&&t.bindingRef&&e.add("entity:"+t.bindingRef));const i=new Set;for(const t of this._devices)"device"===t.bindingKind&&t.name&&i.add(t.name.trim()+"|"+(t.area||""));const s=[];for(const a of Object.values(t.devices)){if("service"===a.entry_type)continue;const t="device:"+a.id;if(e.has(t))continue;const o=(a.name_by_user||a.name||a.id).trim();t!==this._markerDialog?.binding&&i.has(o+"|"+(a.area_id||""))||s.push({value:t,label:o,sub:(a.model||"устройство")+("Group"===a.model?" · Z2M-группа":"")})}const a=new Set(["group","template","derivative","min_max","threshold","integration","statistics","trend","utility_meter","tod","switch_as_x","schedule"]);for(const[i,o]of Object.entries(t.entities)){const n="entity:"+i;if(e.has(n))continue;const r=a.has(o.platform),l="group"===o.platform;if(!r&&!l)continue;if(o.hidden)continue;const c=t.states[i];s.push({value:n,label:o.name||c?.attributes?.friendly_name||i,sub:i.split(".")[0]+" · "+("group"===o.platform?"группа":"хелпер")})}const o=(this._markerDialog?.bindingFilter||"").toLowerCase().trim(),n=o?s.filter(t=>(t.label+" "+t.sub+" "+t.value).toLowerCase().includes(o)):s;return n.sort((t,e)=>t.label.localeCompare(e.label)),n.slice(0,200)}_allRoomsFlat(){const t=[];for(const e of this._serverCfg?.spaces||[])for(const i of e.rooms||[])i.area&&t.push({value:e.id+"#"+i.area,label:(e.title||e.id)+" · "+i.name});return t}_errText(t){if(!t)return"неизвестная ошибка";if("string"==typeof t)return t;if(t.message)return t.message;if(t.error)return t.error;if(null!=t.code)return"код "+t.code;try{return JSON.stringify(t)}catch{return String(t)}}async _pickMarkerFiles(t){const e=t.target,i=e.files?[...e.files]:[];if(e.value="",!i.length||!this._markerDialog)return;const s=this._markerDialog.devId||"new",a=[];for(const t of i)try{const e=new FormData;e.append("marker_id",s),e.append("file",t,t.name);const i=this.hass?.fetchWithAuth?await this.hass.fetchWithAuth("/api/houseplan/upload",{method:"POST",body:e}):await fetch("/api/houseplan/upload",{method:"POST",body:e,headers:this.hass?.auth?.data?.access_token?{authorization:`Bearer ${this.hass.auth.data.access_token}`}:{}}),o=await i.json().catch(()=>({}));if(!i.ok||o.error){const t={too_large:"файл больше "+(o.max_mb||25)+" МБ",bad_ext:"недопустимый тип (нужен PDF/изображение)",unauthorized:"нужны права администратора"};throw new Error(t[o.error]||o.error||"HTTP "+i.status)}a.push({name:o.name||t.name,url:o.url})}catch(e){this._showToast("Файл «"+t.name+"» не загружен: "+this._errText(e))}a.length&&this._markerDialog&&(this._markerDialog={...this._markerDialog,pdfs:[...this._markerDialog.pdfs,...a]},this._showToast("Прикреплено файлов: "+a.length))}_removeMarkerPdf(t){this._markerDialog&&(this._markerDialog={...this._markerDialog,pdfs:this._markerDialog.pdfs.filter(e=>e.url!==t)})}async _saveMarker(){const t=this._markerDialog;if(t&&!t.busy)if("virtual"!==t.binding||t.name.trim()){this._markerDialog={...t,busy:!0};try{const e=this._serverCfg;let i;e.markers=e.markers||[];const[s,a]=t.room?t.room.split("#"):["",""];let o=s||null,n=a||null;"virtual"!==t.binding||o||(o=this._space),i=function(t,e,i){const[s,a]=t.split(":");return"device"===s?a:"entity"===s?"lg_"+a:e&&e.startsWith("v_")?e:i()}(t.binding,t.devId,()=>"v_"+Date.now().toString(36));const r=t.devId,l={id:i,binding:t.binding,name:t.name.trim()||null,icon:t.icon||null,model:t.model.trim()||null,link:t.link.trim()||null,description:t.description.trim()||null,pdfs:t.pdfs};("virtual"===t.binding||t.room)&&(l.space=o,l.area=n);const c=r?this._devices.find(t=>t.id===r):null,h=!!t.room&&null!=c&&(c.space!==o||c.area!==n);e.markers=e.markers.filter(t=>t.id!==i&&t.id!==r),e.markers.push(l);let d=null;if(!this._layout[i]||h){const t=this._spaceModel(o||void 0);let e=t.vb[0]+t.vb[2]/2,s=t.vb[1]+t.vb[3]/2;if(n){const i=t.rooms.find(t=>t.area===n);i&&([e,s]=this._roomCenter(i))}d=this._normPos(o||this._space,e,s),this._layout={...this._layout,[i]:d}}await this._saveConfigNow(),d&&await this.hass.callWS({type:"houseplan/layout/update",device_id:i,pos:d}),r&&r!==i&&(delete this._layout[r],await this.hass.callWS({type:"houseplan/layout/delete",device_id:r}).catch(()=>{})),this._markerDialog=null,this._regSignature="",this._maybeRebuildDevices(),this._showToast("Устройство сохранено")}catch(t){this._markerDialog={...this._markerDialog,busy:!1},this._showToast("Ошибка: "+this._errText(t))}}else this._showToast("Укажите имя виртуального устройства")}async _deleteMarker(){const t=this._markerDialog;if(!t)return;const e=t.devId?this._devices.find(e=>e.id===t.devId):null,i=t.name||"устройство";if(!confirm(`Убрать «${i}» с плана?`))return;const s=this._serverCfg;s.markers=s.markers||[],e&&"virtual"===e.bindingKind?s.markers=s.markers.filter(t=>t.id!==e.id):e&&e.marker?(s.markers=s.markers.filter(t=>t.id!==e.id),"device"===e.bindingKind&&e.bindingRef?s.markers.push({id:e.id,binding:"device:"+e.bindingRef,hidden:!0}):"entity"===e.bindingKind&&e.bindingRef&&s.markers.push({id:e.id,binding:"entity:"+e.bindingRef,hidden:!0})):e&&"device"===e.bindingKind&&e.bindingRef?s.markers.push({id:e.id,binding:"device:"+e.bindingRef,hidden:!0}):e&&"entity"===e.bindingKind&&e.bindingRef&&s.markers.push({id:e.id,binding:"entity:"+e.bindingRef,hidden:!0});try{await this._saveConfigNow(),e&&"virtual"===e.bindingKind&&this._layout[e.id]&&(delete this._layout[e.id],await this.hass.callWS({type:"houseplan/layout/delete",device_id:e.id}).catch(()=>{})),this._markerDialog=null,this._regSignature="",this._maybeRebuildDevices(),this._showToast("Устройство убрано с плана")}catch(t){this._showToast("Ошибка: "+this._errText(t))}}_normPos(t,e,i){const s=this._serverCfg.spaces.find(e=>e.id===t)?.aspect||1;return{s:t,x:e/Et,y:i/(Et/s)}}_openSpaceDialog(t,e){if(this._serverStorage&&this._serverCfg)if("edit"===t){const i=this._serverCfg.spaces.find(t=>t.id===e);if(!i)return;this._spaceDialog={mode:t,spaceId:e,title:i.title,planUrl:i.plan_url||null,planFile:null,busy:!1}}else this._spaceDialog={mode:t,title:"",planUrl:null,planFile:null,busy:!1};else this._showToast("Интеграция House Plan не установлена — управление недоступно")}async _pickPlanFile(t){const e=t.target,i=e.files?.[0];if(!i||!this._spaceDialog)return;const s={"image/svg+xml":"svg","image/png":"png","image/jpeg":"jpg","image/webp":"webp"}[i.type]||(i.name.toLowerCase().endsWith(".svg")?"svg":"");if(!s)return void this._showToast("Поддерживаются SVG, PNG, JPG, WebP");const a=new Uint8Array(await i.arrayBuffer());let o="";for(let t=0;t{const e=new Image;e.onload=()=>t(e.naturalWidth&&e.naturalHeight?e.naturalWidth/e.naturalHeight:1.414),e.onerror=()=>t(1.414),e.src=r});URL.revokeObjectURL(r),this._spaceDialog={...this._spaceDialog,planFile:{ext:s,b64:n,aspect:l,name:i.name}}}async _saveSpaceDialog(){const t=this._spaceDialog;if(!t||t.busy||!t.title.trim())return;if(!t.planFile&&!t.planUrl)return void this._showToast("Загрузите подложку — план этажа обязателен");const e="create"===t.mode&&0===(this._serverCfg?.spaces.length||0);this._spaceDialog={...t,busy:!0};try{const i=this._serverCfg;let s;if("create"===t.mode?(s={id:"s"+Date.now().toString(36),title:t.title.trim(),plan_url:null,aspect:1.414,view_box:[0,0,1,1],rooms:[],segments:[]},i.spaces.push(s)):(s=i.spaces.find(e=>e.id===t.spaceId),s.title=t.title.trim()),t.planFile){const e=await this.hass.callWS({type:"houseplan/plan/set",space_id:s.id,ext:t.planFile.ext,data:t.planFile.b64});s.plan_url=e.url,s.aspect=t.planFile.aspect}await this._saveConfigNow(),this._spaceDialog=null,"create"===t.mode&&(this._space=s.id),this._regSignature="",this._maybeRebuildDevices(),e?(this._markup=!0,this._tool="draw",this._path=[],this._cursorPt=null,this._showToast("Пространство добавлено. Обведите комнаты: кликайте по точкам сетки и замкните контур.")):this._showToast("create"===t.mode?"Пространство добавлено":"Пространство сохранено")}catch(t){this._spaceDialog={...this._spaceDialog,busy:!1},this._showToast("Ошибка: "+this._errText(t))}}async _deleteSpace(){const t=this._spaceDialog;if(!t||"edit"!==t.mode)return;const e=this._serverCfg.spaces.find(e=>e.id===t.spaceId);if(confirm(`Удалить пространство «${e.title}» со всеми комнатами и разметкой?`)){this._serverCfg.spaces=this._serverCfg.spaces.filter(e=>e.id!==t.spaceId);try{await this._saveConfigNow(),this._spaceDialog=null,this._space===t.spaceId&&(this._space=this._serverCfg.spaces[0]?.id||""),this._regSignature="",this._maybeRebuildDevices(),this._showToast("Пространство удалено")}catch(t){this._showToast("Ошибка удаления: "+this._errText(t))}}}async _saveConfigNow(){const t=await this.hass.callWS({type:"houseplan/config/set",config:this._serverCfg,expected_rev:this._cfgRev});this._cfgRev=t?.rev??this._cfgRev+1}render(){if(!this._config||!this.hass)return B;const t=this._model;if(!t.length)return j`
+ `,Et="houseplan_card_layout_v1",Rt="houseplan_card_cfg_v1",Tt="houseplan_card_zoom_v1",Ot=1e3,Ut=(t,e,i)=>{const s=new Event(e,{bubbles:!0,composed:!0});s.detail=i??{},t.dispatchEvent(s)},Ht=(t,e)=>{let i;return(...s)=>{clearTimeout(i),i=window.setTimeout(()=>t(...s),e)}};class Nt extends nt{constructor(){super(...arguments),this._space="f1",this._layout={},this._serverStorage=!1,this._loadOk=!1,this._loading=!1,this._loadTries=0,this._serverCfg=null,this._cfgRev=0,this._unsubCfg=null,this._devices=[],this._regSignature="",this._defPos={},this._tip=null,this._selId=null,this._toast="",this._markup=!1,this._tool="draw",this._path=[],this._pathSegs=[],this._cursorPt=null,this._areaSel="",this._nameSel="",this._roomDialog=!1,this._zoom=1,this._view=null,this._zoomBySpace={},this._pointers=new Map,this._panStart=null,this._pinchStart=null,this._suppressClick=!1,this._onboardingShown=!1,this._infoCard=null,this._markerDialog=null,this._spaceDialog=null,this._keyHandler=t=>this._onKey(t),this._drag=null,this._dirtyPos=new Set,this._persistLayout=Ht(()=>{if(this._serverStorage){const t=[...this._dirtyPos];this._dirtyPos.clear();for(const e of t){const t=this._layout[e];t&&this.hass.callWS({type:"houseplan/layout/update",device_id:e,pos:t}).catch(t=>this._showToast(this._t("toast.pos_save_failed",{err:this._errText(t)})))}this._cacheSnapshot()}else localStorage.setItem(Et,JSON.stringify(this._layout))},600),this._saveConfig=Ht(()=>{this._serverCfg&&this.hass.callWS({type:"houseplan/config/set",config:this._serverCfg,expected_rev:this._cfgRev}).then(t=>{this._cfgRev=t?.rev??this._cfgRev+1}).catch(t=>{"conflict"===t?.code?(this._showToast(this._t("toast.conflict")),this._cancelPath(),this._reloadConfigOnly()):this._showToast(this._t("toast.cfg_save_failed",{err:this._errText(t)}))})},500)}connectedCallback(){super.connectedCallback(),window.addEventListener("keydown",this._keyHandler)}disconnectedCallback(){window.removeEventListener("keydown",this._keyHandler),this._roViewport?.disconnect(),this._roViewport=void 0,this._unsubCfg&&(this._unsubCfg(),this._unsubCfg=null),super.disconnectedCallback()}_onKey(t){if("Escape"===t.key){if(this._infoCard)return void(this._infoCard=null);if(this._markerDialog)return void(this._markerDialog=null)}if(!this._markup)return;return"Escape"===t.key||(t.ctrlKey||t.metaKey)&&"z"===t.key.toLowerCase()?this._roomDialog?(t.preventDefault(),void this._roomDialogCancel()):void("draw"===this._tool&&this._path.length&&(t.preventDefault(),this._undoPoint())):void 0}_undoPoint(){if(!this._path.length)return;if(1===this._path.length)return this._path=[],void(this._pathSegs=[]);const t=this._pathSegs[this._pathSegs.length-1];this._pathSegs=this._pathSegs.slice(0,-1),t&&this._removeSegmentByKey(t),this._path=this._path.slice(0,-1)}_removeSegmentByKey(t){const e=this._curSpaceCfg;if(!e?.segments)return;const i=this._segments.findIndex(e=>this._segKey([e[0],e[1]],[e[2],e[3]])===t);i>=0&&(e.segments.splice(i,1),this._saveConfig())}static getConfigElement(){return document.createElement("houseplan-card-editor")}static getStubConfig(){return{type:"custom:houseplan-card"}}setConfig(t){this._config={icon_size:2.5,show_temperature:!0,live_states:!0,show_signal:!0,...t},t.default_floor&&(this._space=t.default_floor);try{this._zoomBySpace=JSON.parse(localStorage.getItem(Tt)||"{}")||{}}catch{this._zoomBySpace={}}try{const e=JSON.parse(localStorage.getItem(Rt)||"null");e&&e.config&&Array.isArray(e.config.spaces)&&(this._serverCfg=e.config,this._cfgRev=e.rev||0,this._layout=e.layout||{},this._serverStorage=!0,t.default_floor?this._space=t.default_floor:this._model.find(t=>t.id===this._space)||(this._space=this._model[0]?.id||this._space))}catch{}}_cacheSnapshot(){if(this._serverCfg)try{localStorage.setItem(Rt,JSON.stringify({config:this._serverCfg,rev:this._cfgRev,layout:this._layout}))}catch{}}getCardSize(){return 12}get _norm(){return!(!this._serverCfg||!this._serverCfg.spaces.length)}get _model(){return this._serverCfg?this._serverCfg.spaces.map(t=>{const e=Ot/t.aspect;return{id:t.id,title:t.title,vb:[t.view_box[0]*Ot,t.view_box[1]*e,t.view_box[2]*Ot,t.view_box[3]*e],bg:t.plan_url?{href:t.plan_url,x:0,y:0,w:Ot,h:e}:null,rooms:t.rooms.map(t=>({id:t.id,name:t.name,area:t.area??null,x:null!=t.x?t.x*Ot:void 0,y:null!=t.y?t.y*e:void 0,w:null!=t.w?t.w*Ot:void 0,h:null!=t.h?t.h*e:void 0,poly:t.poly?t.poly.map(t=>[t[0]*Ot,t[1]*e]):void 0}))}}):[]}_spaceModel(t){const e=this._model;return e.find(e=>e.id===(t??this._space))||e[0]}get _areaToSpace(){const t={};for(const e of this._model)for(const i of e.rooms)i.area&&(t[i.area]={space:e.id,room:i});return t}get _settings(){return this._serverCfg?.settings||{}}get _showAll(){return!!this._settings.show_all}_toggleShowAll(){this._serverCfg&&(this._serverCfg={...this._serverCfg,settings:{...this._serverCfg.settings,show_all:!this._showAll}},this._regSignature="",this._maybeRebuildDevices(),this._saveConfig(),this.requestUpdate())}get _excluded(){const t=this._settings.exclude_integrations;return t?new Set(t):ct}willUpdate(t){t.has("hass")&&this.hass&&(!this._loadOk&&!this._loading&&this._loadTries<8&&this._loadFromServer(),this._maybeRebuildDevices())}updated(){const t=this._stageEl;t&&!this._roViewport&&(this._roViewport=new ResizeObserver(()=>this._refitView()),this._roViewport.observe(t)),t&&!this._view&&this._refitView(),this._serverStorage&&this._loadOk&&0===this._model.length&&!this._spaceDialog&&!this._onboardingShown&&(this._onboardingShown=!0,this._openSpaceDialog("create"))}async _loadFromServer(){this._loading=!0,this._loadTries++;try{const[t,e]=await Promise.all([this.hass.callWS({type:"houseplan/config/get"}),this.hass.callWS({type:"houseplan/layout/get"})]);this._loadOk=!0,this._serverStorage=!0;const i=t?.config;this._serverCfg=i&&Array.isArray(i.spaces)?i:null,this._cfgRev=t?.rev||0,this._layout=e?.layout||{},this._unsubCfg||(this._unsubCfg=await this.hass.connection.subscribeEvents(t=>{(t?.data?.rev??-1)!==this._cfgRev&&this._reloadConfigOnly()},"houseplan_config_updated")),this._norm&&!this._model.find(t=>t.id===this._space)&&(this._space=this._model[0]?.id||this._space),this._cacheSnapshot(),this._restoreZoom()}catch(t){if(this._loadTries>=8){this._serverStorage=!1,this._serverCfg=null;try{this._layout=JSON.parse(localStorage.getItem(Et)||"{}")||{}}catch{this._layout={}}}}finally{this._loading=!1}this._regSignature="",this.requestUpdate()}async _reloadConfigOnly(){try{const t=await this.hass.callWS({type:"houseplan/config/get"}),e=t?.config;this._serverCfg=e&&Array.isArray(e.spaces)?e:null,this._cfgRev=t?.rev||0,this._cacheSnapshot(),this._regSignature="",this._maybeRebuildDevices(),this.requestUpdate()}catch{}}_maybeRebuildDevices(){const t=this.hass;if(!t?.devices||!t?.entities||!t?.areas)return;const e=Object.keys(t.devices).length+":"+Object.keys(t.entities).length+":"+Object.keys(t.areas).length+":"+(this._norm?"n":"l")+":"+zt(t,this._config?.language);e===this._regSignature&&this._devices.length||(this._regSignature=e,this._devices=St({hass:t,areaToSpace:Object.fromEntries(Object.entries(this._areaToSpace).map(([t,e])=>[t,e.space])),markers:this._markers,settings:this._settings,excluded:this._excluded,showAll:this._showAll,firstSpaceId:this._model[0]?.id||"",loc:t=>this._t(t)}),this._defPos=this._defaultPositions())}get _markers(){return this._serverCfg?.markers||[]}_roomLqi(t){if(!t)return null;const e=[];for(const i of this._devices){if(i.area!==t||i.virtual)continue;const s=xt(this.hass,i.entities);null!=s&&e.push(s)}return mt(e)}_roomBounds(t){if(t.poly&&t.poly.length){const e=t.poly.map(t=>t[0]),i=t.poly.map(t=>t[1]),s=Math.min(...e),a=Math.min(...i);return{x:s,y:a,w:Math.max(...e)-s,h:Math.max(...i)-a}}return{x:t.x??0,y:t.y??0,w:t.w??0,h:t.h??0}}_defaultPositions(){const t={},e=(this._config?.icon_size??2.5)/100*Ot*1.3;for(const i of this._model)for(const s of i.rooms){if(!s.area)continue;const a=this._devices.filter(t=>t.area===s.area&&t.space===i.id);if(!a.length)continue;const o=this._roomBounds(s),r=.1*Math.min(o.w,o.h),n=o.w-2*r,l=o.h-2*r,c=Math.max(1,Math.round(Math.sqrt(a.length*n/Math.max(l,1)))),h=Math.ceil(a.length/c),d=n/c,p=l/Math.max(h,1),_=a.map((t,e)=>({x:o.x+r+d*(e%c+.5),y:o.y+r+p*(Math.floor(e/c)+.5)}));ft(_,o,e,.5*r),a.forEach((e,i)=>t[e.id]=_[i])}return t}_pos(t){const e=this._spaceModel(t.space),i=this._layout[t.id];if(i)if(this._norm){if(i.s===t.space){const e=this._serverCfg.spaces.find(e=>e.id===t.space)?.aspect||1;return{x:i.x*Ot,y:i.y*(Ot/e)}}}else if(void 0===i.s)return{x:i.x,y:i.y};if(this._defPos[t.id])return this._defPos[t.id];const s=e.vb;return{x:s[0]+s[2]/2,y:s[1]+s[3]/2}}_savePos(t,e,i){if(this._norm){const s=this._gridPitch,a=Math.round(e/s)*s,o=Math.round(i/s)*s,r=this._serverCfg.spaces.find(e=>e.id===t.space)?.aspect||1;this._layout={...this._layout,[t.id]:{s:t.space,x:a/Ot,y:o/(Ot/r)}}}else this._layout={...this._layout,[t.id]:{x:Math.round(e),y:Math.round(i)}};this._dirtyPos.add(t.id),this._persistLayout()}_stateClass(t){if(!this._config?.live_states)return"";const e=t.primary?this.hass.states[t.primary]:void 0;if(!e)return"";if("unavailable"===e.state)return"unavail";const i=e.entity_id.split(".")[0];if(["light","switch","fan","humidifier"].includes(i))return"on"===e.state?"on":"";if("cover"===i||"valve"===i)return["open","opening"].includes(e.state)?"open":"";if("lock"===i)return["unlocked","open"].includes(e.state)?"open":"";if("binary_sensor"===i){const t=e.attributes?.device_class;if(["door","window","garage_door","opening","gas","smoke","moisture","problem"].includes(t))return"on"===e.state?"open":""}return"media_player"===i?["playing","on"].includes(e.state)?"on":"":"vacuum"===i&&["cleaning","returning"].includes(e.state)?"on":""}_liveTemp(t){return this._config?.show_temperature?"mdi:thermometer"!==t.icon&&"mdi:air-filter"!==t.icon?null:wt(this.hass,t.entities):null}_openMoreInfo(t){t?Ut(this,"hass-more-info",{entityId:t}):this._showToast(this._t("toast.no_entity"))}_clickDevice(t,e){t.stopPropagation(),this._drag?.moved||this._suppressClick||this._markup||(this._infoCard=e)}_t(t,e){return Dt(zt(this.hass,this._config?.language),t,e)}get _stageEl(){return this.renderRoot.querySelector(".stage")}_stageAspect(){const t=this._stageEl,e=this._spaceModel().vb;return t&&t.clientHeight?t.clientWidth/t.clientHeight:e[2]/e[3]}_viewOr(t){return this._view&&this._view.w?this._view:gt(t,this._stageAspect())}_screenToVb(t,e){const i=this._stageEl,s=this._viewOr(this._spaceModel().vb),a=i?.clientWidth||1,o=i?.clientHeight||1;return[s.x+t/a*s.w,s.y+e/o*s.h]}_clampView(t,e){return{w:t.w,h:t.h,x:Math.max(e.x,Math.min(e.x+e.w-t.w,t.x)),y:Math.max(e.y,Math.min(e.y+e.h-t.h,t.y))}}_applyView(t,e,i){const s=this._spaceModel().vb,a=gt(s,this._stageAspect()),o=Math.min(8,Math.max(1,t)),r=a.w/o,n=a.h/o,l=this._viewOr(s),c=e??l.x+l.w/2,h=i??l.y+l.h/2;this._zoom=o,this._view=this._clampView({x:c-r/2,y:h-n/2,w:r,h:n},a)}_refitView(){if(!this._stageEl)return;const t=this._view;this._applyView(this._zoom,t?t.x+t.w/2:void 0,t?t.y+t.h/2:void 0),this.requestUpdate()}_zoomAt(t,e,i){const s=this._stageEl;if(!s)return;const a=gt(this._spaceModel().vb,this._stageAspect()),o=Math.min(8,Math.max(1,i)),r=s.clientWidth,n=s.clientHeight,l=this._screenToVb(t,e),c=a.w/o,h=a.h/o;this._zoom=o,this._view=this._clampView({x:l[0]-t/r*c,y:l[1]-e/n*h,w:c,h:h},a)}_onWheel(t){const e=this._stageEl;if(!e)return;t.preventDefault();const i=e.getBoundingClientRect(),s=t.deltaY<0?1.15:1/1.15;this._zoomAt(t.clientX-i.left,t.clientY-i.top,this._zoom*s),this._saveZoom()}_stepZoom(t){const e=this._stageEl;e&&(this._zoomAt(e.clientWidth/2,e.clientHeight/2,this._zoom*(t>0?1.4:1/1.4)),this._saveZoom())}_resetZoom(){const t=this._spaceModel().vb;this._zoom=1,this._view=gt(t,this._stageAspect()),this._saveZoom()}_saveZoom(){this._zoomBySpace={...this._zoomBySpace,[this._space]:this._zoom};try{localStorage.setItem(Tt,JSON.stringify(this._zoomBySpace))}catch{}}_restoreZoom(){const t=this._zoomBySpace[this._space]||1;this._zoom=t,this._view=null,requestAnimationFrame(()=>{if(!this._stageEl)return;const e=this._spaceModel().vb;this._applyView(t,e[0]+e[2]/2,e[1]+e[3]/2),this.requestUpdate()})}_stagePointerDown(t){if(this._drag||this._markup)return;if(t.target.closest(".dev"))return;this._pointers.set(t.pointerId,{x:t.clientX,y:t.clientY});const e=this._viewOr(this._spaceModel().vb);if(1===this._pointers.size)this._panStart={sx:t.clientX,sy:t.clientY,vx:e.x,vy:e.y},this._suppressClick=!1;else if(2===this._pointers.size){const t=[...this._pointers.values()],e=Math.hypot(t[0].x-t[1].x,t[0].y-t[1].y);this._pinchStart={dist:e,zoom:this._zoom},this._panStart=null}}_stagePointerMove(t){if(this._pointers.has(t.pointerId)){if(this._pointers.set(t.pointerId,{x:t.clientX,y:t.clientY}),this._pinchStart&&this._pointers.size>=2){const t=[...this._pointers.values()],e=Math.hypot(t[0].x-t[1].x,t[0].y-t[1].y)/(this._pinchStart.dist||1),i=this._stageEl.getBoundingClientRect(),s=(t[0].x+t[1].x)/2-i.left,a=(t[0].y+t[1].y)/2-i.top;this._zoomAt(s,a,this._pinchStart.zoom*e),this._suppressClick=!0,this._saveZoom()}else if(this._panStart){const e=t.clientX-this._panStart.sx,i=t.clientY-this._panStart.sy;if(Math.abs(e)+Math.abs(i)>4&&(this._suppressClick=!0),this._zoom>1&&this._view){const t=this._stageEl,s=this._view,a=gt(this._spaceModel().vb,this._stageAspect());this._view=this._clampView({x:this._panStart.vx-e/t.clientWidth*s.w,y:this._panStart.vy-i/t.clientHeight*s.h,w:s.w,h:s.h},a)}}}else this._markupMove(t)}_stagePointerUp(t){this._pointers.delete(t.pointerId),this._pointers.size<2&&(this._pinchStart=null),0===this._pointers.size&&(this._panStart=null,setTimeout(()=>this._suppressClick=!1,0))}_clickRoom(t){var e;!this._suppressClick&&t.area&&(e="/config/areas/area/"+t.area,history.pushState(null,"",e),Ut(window,"location-changed",{replace:!1}))}_pointerDown(t,e){if(this._markup)return;t.preventDefault();const i=this._pos(e);this._drag={id:e.id,sx:t.clientX,sy:t.clientY,ox:i.x,oy:i.y,moved:!1},t.target.setPointerCapture(t.pointerId),this._tip=null}_pointerMove(t,e){if(!this._drag||this._drag.id!==e.id)return;const i=this.renderRoot.querySelector(".stage");if(!i)return;const s=this._spaceModel().vb,a=i.getBoundingClientRect(),o=this._viewOr(s),r=(t.clientX-this._drag.sx)/a.width*o.w,n=(t.clientY-this._drag.sy)/a.height*o.h;Math.abs(t.clientX-this._drag.sx)+Math.abs(t.clientY-this._drag.sy)>3&&(this._drag.moved=!0);const l=.008*Math.min(s[2],s[3]),c=Math.max(s[0]+l,Math.min(s[0]+s[2]-l,this._drag.ox+r)),h=Math.max(s[1]+l,Math.min(s[1]+s[3]-l,this._drag.oy+n));this._savePos(e,c,h)}_pointerUp(t,e){if(!this._drag||this._drag.id!==e.id)return;const i=this._drag.moved;this._drag=i?this._drag:null,i&&(this._selId=e.id,window.setTimeout(()=>this._drag=null,0))}_resetLayout(){confirm(this._t("confirm.reset_layout"))&&(this._layout={},this._persistLayout())}_showToast(t){this._toast=t,clearTimeout(this._toastTimer),this._toastTimer=window.setTimeout(()=>{this._toast=""},3500)}_showTip(t,e,i,s){this._drag||(this._tip={x:t.clientX,y:t.clientY,title:e,meta:i,lqi:s})}get _gridPitch(){return Ot/240}get _curSpaceCfg(){return this._serverCfg?.spaces.find(t=>t.id===this._space)}get _spaceH(){const t=this._curSpaceCfg;return t?Ot/t.aspect:Ot}get _segments(){const t=this._curSpaceCfg,e=this._spaceH;return(t?.segments||[]).map(t=>[t[0]*Ot,t[1]*e,t[2]*Ot,t[3]*e])}_toggleMarkup(){this._norm?(this._markup=!this._markup,this._path=[],this._cursorPt=null,this._tool="draw"):this._showToast(this._t("toast.markup_needs_server"))}_svgPoint(t){const e=this.renderRoot.querySelector(".stage").getBoundingClientRect();return this._screenToVb(t.clientX-e.left,t.clientY-e.top)}_snap(t){const e=this._gridPitch;return[ut(t[0],e),ut(t[1],e)]}_samePt(t,e){return function(t,e,i=.001){return Math.abs(t[0]-e[0])this._segKey([t[0],t[1]],[t[2],t[3]])===a);return!o&&(i.segments=i.segments||[],i.segments.push([t[0]/Ot,t[1]/s,e[0]/Ot,e[1]/s]),this._saveConfig(),!0)}_distToSeg(t,e){const[i,s]=t,[a,o,r,n]=e,l=r-a,c=n-o;let h=((i-a)*l+(s-o)*c)/(l*l+c*c||1);h=Math.max(0,Math.min(1,h));const d=a+h*l,p=o+h*c;return Math.hypot(i-d,s-p)}_pointInRoom(t,e){return e.poly?function(t,e){let i=!1;for(let s=0,a=e.length-1;st[1]!=l>t[1]&&t[0]<(n-o)*(t[1]-r)/(l-r)+o&&(i=!i)}return i}(t,e.poly):null!=e.x&&t[0]>=e.x&&t[0]<=e.x+e.w&&t[1]>=e.y&&t[1]<=e.y+e.h}_markupClick(t){if(!this._markup)return;const e=this._svgPoint(t);if("erase"===this._tool){const t=this._curSpaceCfg;if(!t?.segments?.length)return;const i=this._segments;let s=-1,a=.5*this._gridPitch;return i.forEach((t,i)=>{const o=this._distToSeg(e,t);o=0&&(t.segments.splice(s,1),this._saveConfig(),this.requestUpdate()))}if("delroom"===this._tool){const t=[...this._spaceModel().rooms].reverse().find(t=>this._pointInRoom(e,t));if(!t)return;if(!confirm(this._t("confirm.delete_room",{name:t.name})))return;const i=this._curSpaceCfg;return i.rooms=i.rooms.filter(e=>e.id!==t.id),this._saveConfig(),this._regSignature="",this._maybeRebuildDevices(),void this.requestUpdate()}const i=this._snap(e);if(!this._path.length)return this._path=[i],void(this._pathSegs=[]);const s=this._path[this._path.length-1];if(this._samePt(i,s))return;const a=this._addSegment(s,i);this._pathSegs=[...this._pathSegs,a?this._segKey(s,i):null],this._path=[...this._path,i],this._path.length>=4&&this._samePt(i,this._path[0])&&(this._cursorPt=null,this._nameSel="",this._areaSel="",this._roomDialog=!0)}get _contourClosed(){return this._path.length>=4&&this._samePt(this._path[0],this._path[this._path.length-1])}_markupMove(t){this._markup&&"draw"===this._tool&&this._path.length&&!this._contourClosed&&(this._cursorPt=this._snap(this._svgPoint(t)))}_saveRoom(){this._areaSel&&this._commitRoom()}_saveRoomNoArea(){this._nameSel.trim()&&(this._areaSel="",this._commitRoom())}_commitRoom(){if(!this._contourClosed)return;const t=this._curSpaceCfg;if(!t)return;const e=this._spaceH,i=this._path.slice(0,-1),s=this._areaSel?this.hass.areas[this._areaSel]?.name:"";t.rooms.push({id:"r"+Date.now().toString(36),name:this._nameSel||s||this._t("room.default_name"),area:this._areaSel||null,poly:i.map(t=>[t[0]/Ot,t[1]/e])}),this._saveConfig(),this._path=[],this._pathSegs=[];const a=this._areaSel;this._areaSel="",this._nameSel="",this._roomDialog=!1,this._regSignature="",this._maybeRebuildDevices();let o=0;if(a){const t=this._serverCfg?.spaces.find(t=>t.id===this._space)?.aspect||1,e=Ot/t,i={...this._layout};for(const t of this._devices){if(t.area!==a||t.space!==this._space)continue;if(o++,this._layout[t.id])continue;const s=this._defPos[t.id];s&&(i[t.id]={s:this._space,x:s.x/Ot,y:s.y/e},this._dirtyPos.add(t.id))}this._layout=i,this._persistLayout()}const r=this._model.find(t=>t.id===this._space)?.rooms.length||0;this._showToast(a?this._t("toast.room_saved",{n:r,added:o}):this._t("toast.room_saved_no_area",{n:r}))}_cancelPath(){this._path=[],this._pathSegs=[],this._cursorPt=null,this._roomDialog=!1}_roomDialogCancel(){this._roomDialog=!1,this._undoPoint()}get _freeAreas(){const t=new Set;for(const e of this._serverCfg?.spaces||[])for(const i of e.rooms||[])i.area&&t.add(i.area);return Object.values(this.hass?.areas||{}).filter(e=>!t.has(e.area_id)).sort((t,e)=>(t.name||"").localeCompare(e.name||""))}_openMarkerDialog(t){this._norm?this._markerDialog=t?{devId:t.id,name:t.name,binding:"virtual"===t.bindingKind?"virtual":t.bindingKind+":"+t.bindingRef,bindingFilter:"",icon:t.marker?.icon||"",model:t.model||"",link:t.link||"",description:t.description||"",pdfs:[...t.pdfs||[]],room:t.space&&t.area?t.space+"#"+t.area:"",busy:!1}:{name:"",binding:"virtual",bindingFilter:"",icon:"",model:"",link:"",description:"",pdfs:[],room:"",busy:!1}:this._showToast(this._t("toast.marker_needs_server"))}_bindingCandidates(){const t=this.hass,e=new Set;for(const t of this._devices)t.id!==this._markerDialog?.devId&&("device"===t.bindingKind&&t.bindingRef&&e.add("device:"+t.bindingRef),"entity"===t.bindingKind&&t.bindingRef&&e.add("entity:"+t.bindingRef));const i=new Set;for(const t of this._devices)"device"===t.bindingKind&&t.name&&i.add(t.name.trim()+"|"+(t.area||""));const s=[];for(const a of Object.values(t.devices)){if("service"===a.entry_type)continue;const t="device:"+a.id;if(e.has(t))continue;const o=(a.name_by_user||a.name||a.id).trim();t!==this._markerDialog?.binding&&i.has(o+"|"+(a.area_id||""))||s.push({value:t,label:o,sub:(a.model||this._t("marker.sub_device"))+("Group"===a.model?this._t("marker.sub_z2m_group"):"")})}const a=new Set(["group","template","derivative","min_max","threshold","integration","statistics","trend","utility_meter","tod","switch_as_x","schedule"]);for(const[i,o]of Object.entries(t.entities)){const r="entity:"+i;if(e.has(r))continue;const n=a.has(o.platform),l="group"===o.platform;if(!n&&!l)continue;if(o.hidden)continue;const c=t.states[i];s.push({value:r,label:o.name||c?.attributes?.friendly_name||i,sub:i.split(".")[0]+" · "+("group"===o.platform?this._t("marker.sub_group"):this._t("marker.sub_helper"))})}const o=(this._markerDialog?.bindingFilter||"").toLowerCase().trim(),r=o?s.filter(t=>(t.label+" "+t.sub+" "+t.value).toLowerCase().includes(o)):s;return r.sort((t,e)=>t.label.localeCompare(e.label)),r.slice(0,200)}_allRoomsFlat(){const t=[];for(const e of this._serverCfg?.spaces||[])for(const i of e.rooms||[])i.area&&t.push({value:e.id+"#"+i.area,label:(e.title||e.id)+" · "+i.name});return t}_errText(t){if(!t)return this._t("err.unknown");if("string"==typeof t)return t;if(t.message)return t.message;if(t.error)return t.error;if(null!=t.code)return this._t("err.code",{code:t.code});try{return JSON.stringify(t)}catch{return String(t)}}async _pickMarkerFiles(t){const e=t.target,i=e.files?[...e.files]:[];if(e.value="",!i.length||!this._markerDialog)return;const s=this._markerDialog.devId||"new",a=[];for(const t of i)try{const e=new FormData;e.append("marker_id",s),e.append("file",t,t.name);const i=this.hass?.fetchWithAuth?await this.hass.fetchWithAuth("/api/houseplan/upload",{method:"POST",body:e}):await fetch("/api/houseplan/upload",{method:"POST",body:e,headers:this.hass?.auth?.data?.access_token?{authorization:`Bearer ${this.hass.auth.data.access_token}`}:{}}),o=await i.json().catch(()=>({}));if(!i.ok||o.error){const t={too_large:this._t("err.too_large",{mb:o.max_mb||25}),bad_ext:this._t("err.bad_ext"),unauthorized:this._t("err.unauthorized")};throw new Error(t[o.error]||o.error||"HTTP "+i.status)}a.push({name:o.name||t.name,url:o.url})}catch(e){this._showToast(this._t("toast.file_failed",{name:t.name,err:this._errText(e)}))}a.length&&this._markerDialog&&(this._markerDialog={...this._markerDialog,pdfs:[...this._markerDialog.pdfs,...a]},this._showToast(this._t("toast.files_attached",{n:a.length})))}_removeMarkerPdf(t){this._markerDialog&&(this._markerDialog={...this._markerDialog,pdfs:this._markerDialog.pdfs.filter(e=>e.url!==t)})}async _saveMarker(){const t=this._markerDialog;if(t&&!t.busy)if("virtual"!==t.binding||t.name.trim()){this._markerDialog={...t,busy:!0};try{const e=this._serverCfg;let i;e.markers=e.markers||[];const[s,a]=t.room?t.room.split("#"):["",""];let o=s||null,r=a||null;"virtual"!==t.binding||o||(o=this._space),i=function(t,e,i){const[s,a]=t.split(":");return"device"===s?a:"entity"===s?"lg_"+a:e&&e.startsWith("v_")?e:i()}(t.binding,t.devId,()=>"v_"+Date.now().toString(36));const n=t.devId,l={id:i,binding:t.binding,name:t.name.trim()||null,icon:t.icon||null,model:t.model.trim()||null,link:t.link.trim()||null,description:t.description.trim()||null,pdfs:t.pdfs};("virtual"===t.binding||t.room)&&(l.space=o,l.area=r);const c=n?this._devices.find(t=>t.id===n):null,h=!!t.room&&null!=c&&(c.space!==o||c.area!==r);e.markers=e.markers.filter(t=>t.id!==i&&t.id!==n),e.markers.push(l);let d=null;if(!this._layout[i]||h){const t=this._spaceModel(o||void 0);let e=t.vb[0]+t.vb[2]/2,s=t.vb[1]+t.vb[3]/2;if(r){const i=t.rooms.find(t=>t.area===r);i&&([e,s]=this._roomCenter(i))}d=this._normPos(o||this._space,e,s),this._layout={...this._layout,[i]:d}}await this._saveConfigNow(),d&&await this.hass.callWS({type:"houseplan/layout/update",device_id:i,pos:d}),n&&n!==i&&(delete this._layout[n],await this.hass.callWS({type:"houseplan/layout/delete",device_id:n}).catch(()=>{})),this._markerDialog=null,this._regSignature="",this._maybeRebuildDevices(),this._showToast(this._t("toast.marker_saved"))}catch(t){this._markerDialog={...this._markerDialog,busy:!1},this._showToast(this._t("toast.error",{err:this._errText(t)}))}}else this._showToast(this._t("toast.virtual_name_required"))}async _deleteMarker(){const t=this._markerDialog;if(!t)return;const e=t.devId?this._devices.find(e=>e.id===t.devId):null,i=t.name||this._t("device.fallback");if(!confirm(this._t("confirm.remove_marker",{name:i})))return;const s=this._serverCfg;s.markers=s.markers||[],e&&"virtual"===e.bindingKind?s.markers=s.markers.filter(t=>t.id!==e.id):e&&e.marker?(s.markers=s.markers.filter(t=>t.id!==e.id),"device"===e.bindingKind&&e.bindingRef?s.markers.push({id:e.id,binding:"device:"+e.bindingRef,hidden:!0}):"entity"===e.bindingKind&&e.bindingRef&&s.markers.push({id:e.id,binding:"entity:"+e.bindingRef,hidden:!0})):e&&"device"===e.bindingKind&&e.bindingRef?s.markers.push({id:e.id,binding:"device:"+e.bindingRef,hidden:!0}):e&&"entity"===e.bindingKind&&e.bindingRef&&s.markers.push({id:e.id,binding:"entity:"+e.bindingRef,hidden:!0});try{await this._saveConfigNow(),e&&"virtual"===e.bindingKind&&this._layout[e.id]&&(delete this._layout[e.id],await this.hass.callWS({type:"houseplan/layout/delete",device_id:e.id}).catch(()=>{})),this._markerDialog=null,this._regSignature="",this._maybeRebuildDevices(),this._showToast(this._t("toast.marker_removed"))}catch(t){this._showToast(this._t("toast.error",{err:this._errText(t)}))}}_normPos(t,e,i){const s=this._serverCfg.spaces.find(e=>e.id===t)?.aspect||1;return{s:t,x:e/Ot,y:i/(Ot/s)}}_openSpaceDialog(t,e){if(this._serverStorage&&this._serverCfg)if("edit"===t){const i=this._serverCfg.spaces.find(t=>t.id===e);if(!i)return;this._spaceDialog={mode:t,spaceId:e,title:i.title,planUrl:i.plan_url||null,planFile:null,busy:!1}}else this._spaceDialog={mode:t,title:"",planUrl:null,planFile:null,busy:!1};else this._showToast(this._t("toast.integration_missing"))}async _pickPlanFile(t){const e=t.target,i=e.files?.[0];if(!i||!this._spaceDialog)return;const s={"image/svg+xml":"svg","image/png":"png","image/jpeg":"jpg","image/webp":"webp"}[i.type]||(i.name.toLowerCase().endsWith(".svg")?"svg":"");if(!s)return void this._showToast(this._t("toast.plan_formats"));const a=new Uint8Array(await i.arrayBuffer());let o="";for(let t=0;t{const e=new Image;e.onload=()=>t(e.naturalWidth&&e.naturalHeight?e.naturalWidth/e.naturalHeight:1.414),e.onerror=()=>t(1.414),e.src=n});URL.revokeObjectURL(n),this._spaceDialog={...this._spaceDialog,planFile:{ext:s,b64:r,aspect:l,name:i.name}}}async _saveSpaceDialog(){const t=this._spaceDialog;if(!t||t.busy||!t.title.trim())return;if(!t.planFile&&!t.planUrl)return void this._showToast(this._t("toast.plan_required"));const e="create"===t.mode&&0===(this._serverCfg?.spaces.length||0);this._spaceDialog={...t,busy:!0};try{const i=this._serverCfg;let s;if("create"===t.mode?(s={id:"s"+Date.now().toString(36),title:t.title.trim(),plan_url:null,aspect:1.414,view_box:[0,0,1,1],rooms:[],segments:[]},i.spaces.push(s)):(s=i.spaces.find(e=>e.id===t.spaceId),s.title=t.title.trim()),t.planFile){const e=await this.hass.callWS({type:"houseplan/plan/set",space_id:s.id,ext:t.planFile.ext,data:t.planFile.b64});s.plan_url=e.url,s.aspect=t.planFile.aspect}await this._saveConfigNow(),this._spaceDialog=null,"create"===t.mode&&(this._space=s.id),this._regSignature="",this._maybeRebuildDevices(),e?(this._markup=!0,this._tool="draw",this._path=[],this._cursorPt=null,this._showToast(this._t("toast.space_added_onboard"))):this._showToast("create"===t.mode?this._t("toast.space_added"):this._t("toast.space_saved"))}catch(t){this._spaceDialog={...this._spaceDialog,busy:!1},this._showToast(this._t("toast.error",{err:this._errText(t)}))}}async _deleteSpace(){const t=this._spaceDialog;if(!t||"edit"!==t.mode)return;const e=this._serverCfg.spaces.find(e=>e.id===t.spaceId);if(confirm(this._t("confirm.delete_space",{title:e.title}))){this._serverCfg.spaces=this._serverCfg.spaces.filter(e=>e.id!==t.spaceId);try{await this._saveConfigNow(),this._spaceDialog=null,this._space===t.spaceId&&(this._space=this._serverCfg.spaces[0]?.id||""),this._regSignature="",this._maybeRebuildDevices(),this._showToast(this._t("toast.space_deleted"))}catch(t){this._showToast(this._t("toast.delete_failed",{err:this._errText(t)}))}}}async _saveConfigNow(){const t=await this.hass.callWS({type:"houseplan/config/set",config:this._serverCfg,expected_rev:this._cfgRev});this._cfgRev=t?.rev??this._cfgRev+1}render(){if(!this._config||!this.hass)return B;const t=this._model;if(!t.length)return F`
`;const e=this._spaceModel(),i=e.vb,s=this._devices.filter(t=>t.space===e.id),a=this._config.icon_size??2.5,o=a>8?2.5:a,n=this._viewOr(i);return j`
+ ${this._toast?F` `;const e=this._spaceModel(),i=e.vb,s=this._devices.filter(t=>t.space===e.id),a=this._config.icon_size??2.5,o=a>8?2.5:a,r=this._viewOr(i);return F`
- `}_renderMarkupLayer(t){const e=this._segments,i=this._path,s=this._gridPitch;return F`
+ `}_renderMarkupLayer(t){const e=this._segments,i=this._path,s=this._gridPitch;return j`
j`
t.stopPropagation()}>
`}}Nt.properties={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},_markup:{state:!0},_tool:{state:!0},_path:{state:!0},_cursorPt:{state:!0},_areaSel:{state:!0},_nameSel:{state:!0},_roomDialog:{state:!0},_spaceDialog:{state:!0},_infoCard:{state:!0},_markerDialog:{state:!0},_zoom:{state:!0},_view:{state:!0}},Nt.styles=Pt,customElements.get("houseplan-card")||customElements.define("houseplan-card",Nt),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.11.0 ","background:#3ea6ff;color:#04121f;font-weight:700","");
diff --git a/custom_components/houseplan/http_api.py b/custom_components/houseplan/http_api.py
index 8c469bd..5414a07 100644
--- a/custom_components/houseplan/http_api.py
+++ b/custom_components/houseplan/http_api.py
@@ -1,7 +1,7 @@
-"""HTTP-эндпоинт загрузки файлов-инструкций House Plan.
+"""HTTP endpoint for uploading House Plan manual files.
-Файлы (PDF и т.п.) грузятся не через WebSocket (у него лимит размера сообщения —
-большой PDF рвёт соединение), а обычным multipart POST — как медиа в самом HA.
+Files (PDF and the like) are uploaded not over WebSocket (its message size limit
+breaks the connection on a large PDF) but via a plain multipart POST — like media in HA itself.
"""
from __future__ import annotations
@@ -12,9 +12,9 @@ from aiohttp import web
from homeassistant.components.http import HomeAssistantView
-try: # KEY_HASS — современный доступ к hass из aiohttp-приложения
+try: # KEY_HASS — the modern way to access hass from the aiohttp application
from homeassistant.components.http import KEY_HASS
-except ImportError: # старые версии HA
+except ImportError: # older HA versions
KEY_HASS = "hass" # type: ignore[assignment]
from homeassistant.core import HomeAssistant
@@ -33,7 +33,7 @@ _CHUNK = 64 * 1024
class HouseplanUploadView(HomeAssistantView):
- """POST /api/houseplan/upload — сохранить файл маркера, вернуть URL."""
+ """POST /api/houseplan/upload — save a marker file, return its URL."""
url = "/api/houseplan/upload"
name = "api:houseplan:upload"
@@ -59,7 +59,7 @@ class HouseplanUploadView(HomeAssistantView):
marker_id = sanitize_marker_id(await part.text())
elif part.name == "file":
filename = part.filename or "file"
- # читаем чанками с обрывом по лимиту, а не весь файл в память
+ # read in chunks, aborting at the limit, instead of loading the whole file into memory
chunks: list[bytes] = []
size = 0
while chunk := await part.read_chunk(_CHUNK):
@@ -72,7 +72,7 @@ class HouseplanUploadView(HomeAssistantView):
break
blob = b"".join(chunks)
except Exception as err: # noqa: BLE001
- _LOGGER.warning("House Plan upload: ошибка чтения multipart: %s", err)
+ _LOGGER.warning("House Plan upload: multipart read error: %s", err)
return web.json_response({"error": "bad_request"}, status=400)
if too_large:
diff --git a/custom_components/houseplan/manifest.json b/custom_components/houseplan/manifest.json
index 62714e6..d0e03ff 100755
--- a/custom_components/houseplan/manifest.json
+++ b/custom_components/houseplan/manifest.json
@@ -15,5 +15,5 @@
"iot_class": "local_push",
"issue_tracker": "https://github.com/Matysh/houseplan-card/issues",
"requirements": [],
- "version": "1.10.0"
+ "version": "1.11.0"
}
\ No newline at end of file
diff --git a/custom_components/houseplan/translations/en.json b/custom_components/houseplan/translations/en.json
index 1f48c02..8e56e6d 100755
--- a/custom_components/houseplan/translations/en.json
+++ b/custom_components/houseplan/translations/en.json
@@ -3,15 +3,15 @@
"step": {
"user": {
"title": "House Plan",
- "data": { "admin_only": "Правка раскладки только администраторами" }
+ "data": { "admin_only": "Only administrators may edit the layout" }
}
},
- "abort": { "single_instance_allowed": "Уже настроено — допускается одна запись." }
+ "abort": { "single_instance_allowed": "Already configured — only one entry is allowed." }
},
"options": {
"step": {
"init": {
- "data": { "admin_only": "Правка раскладки только администраторами" }
+ "data": { "admin_only": "Only administrators may edit the layout" }
}
}
}
diff --git a/custom_components/houseplan/validation.py b/custom_components/houseplan/validation.py
index 0b6667b..fd627e8 100644
--- a/custom_components/houseplan/validation.py
+++ b/custom_components/houseplan/validation.py
@@ -1,6 +1,6 @@
-"""Чистая валидация и санитайзеры House Plan — без зависимостей от Home Assistant.
+"""Pure House Plan validation and sanitizers — no Home Assistant dependencies.
-Вынесено отдельно, чтобы покрывать юнит-тестами (нужен только voluptuous).
+Kept separate so it can be covered by unit tests (only voluptuous is needed).
"""
from __future__ import annotations
@@ -8,7 +8,7 @@ import re
import voluptuous as vol
-# ---------- лимиты и наборы расширений ----------
+# ---------- limits and extension sets ----------
PLAN_EXTENSIONS = {"svg": "image/svg+xml", "png": "image/png", "jpg": "image/jpeg", "webp": "image/webp"}
MAX_PLAN_BYTES = 8 * 1024 * 1024
FILE_EXTENSIONS = {"pdf", "png", "jpg", "jpeg", "webp", "txt"}
@@ -17,27 +17,27 @@ MAX_FILE_BYTES = 25 * 1024 * 1024
SPACE_ID_RE = re.compile(r"^[a-z0-9_-]{1,64}$")
_SAFE_NAME_RE = re.compile(r"[^A-Za-z0-9._-]+")
-# ---------- санитайзеры ----------
+# ---------- sanitizers ----------
def sanitize_marker_id(value: str) -> str:
- """Безопасный идентификатор маркера для имени папки.
+ """Safe marker identifier for a folder name.
- Убирает разделители путей и ведущие точки, чтобы исключить обход каталогов
- (напр. '..', '../x'); пустой/из одних точек результат → 'misc'.
+ Strips path separators and leading dots to rule out directory traversal
+ (e.g. '..', '../x'); an empty/dots-only result → 'misc'.
"""
cleaned = _SAFE_NAME_RE.sub("_", value).lstrip(".")[:64]
return cleaned or "misc"
def sanitize_filename(value: str) -> str:
- """Отбросить путь и ведущие точки, оставить безопасное имя файла."""
+ """Drop the path and leading dots, keep a safe file name."""
raw = value.rsplit("/", 1)[-1].rsplit("\\", 1)[-1]
return _SAFE_NAME_RE.sub("_", raw).lstrip(".")[:120] or "file"
def file_ext(filename: str) -> str:
- """Расширение файла в нижнем регистре ('' если нет)."""
+ """Lowercase file extension ('' if none)."""
raw = filename.rsplit("/", 1)[-1].rsplit("\\", 1)[-1]
return raw.rsplit(".", 1)[-1].lower() if "." in raw else ""
@@ -46,10 +46,10 @@ def valid_space_id(value: str) -> bool:
return bool(SPACE_ID_RE.match(value))
-# ---------- voluptuous-схемы ----------
+# ---------- voluptuous schemas ----------
POS_SCHEMA = vol.Schema(
{vol.Required("x"): vol.Coerce(float), vol.Required("y"): vol.Coerce(float)},
- extra=vol.ALLOW_EXTRA, # v2-записи несут ключ "s" (space id)
+ extra=vol.ALLOW_EXTRA, # v2 records carry the "s" key (space id)
)
LAYOUT_SCHEMA = vol.Schema({str: POS_SCHEMA})
@@ -59,7 +59,7 @@ POINT = vol.All([vol.Coerce(float)], vol.Length(min=2, max=2))
def _require_geometry(room: dict) -> dict:
if "poly" in room or all(k in room for k in ("x", "y", "w", "h")):
return room
- raise vol.Invalid("room: нужен poly или x/y/w/h")
+ raise vol.Invalid("room: poly or x/y/w/h is required")
ROOM_SCHEMA = vol.All(
@@ -115,5 +115,5 @@ CONFIG_SCHEMA = vol.Schema(
vol.Optional("markers", default=list): [MARKER_SCHEMA],
vol.Optional("settings", default=dict): vol.Schema({}, extra=vol.ALLOW_EXTRA),
},
- extra=vol.ALLOW_EXTRA, # неизвестные ключи (легаси) не ломают загрузку
+ extra=vol.ALLOW_EXTRA, # unknown (legacy) keys do not break loading
)
diff --git a/custom_components/houseplan/websocket_api.py b/custom_components/houseplan/websocket_api.py
index a2e7fa6..c04a2a2 100755
--- a/custom_components/houseplan/websocket_api.py
+++ b/custom_components/houseplan/websocket_api.py
@@ -1,4 +1,4 @@
-"""WS-команды House Plan: раскладка, конфигурация пространств, загрузка планов."""
+"""House Plan WS commands: layout, space configuration, plan uploads."""
from __future__ import annotations
import asyncio
@@ -24,7 +24,7 @@ from .validation import (
@callback
def async_register(hass: HomeAssistant) -> None:
- """Регистрация WS-команд."""
+ """Register the WS commands."""
websocket_api.async_register_command(hass, ws_layout_get)
websocket_api.async_register_command(hass, ws_layout_set)
websocket_api.async_register_command(hass, ws_layout_update)
@@ -43,10 +43,10 @@ def _config_store(hass: HomeAssistant):
def _write_lock(hass: HomeAssistant) -> asyncio.Lock:
- """Единый лок на цикл load→modify→save обоих хранилищ.
+ """A single lock over the load→modify→save cycle of both stores.
- Без него параллельные WS-вызовы теряют изменения (last-writer-wins),
- а проверка expected_rev неатомарна.
+ Without it, parallel WS calls lose changes (last-writer-wins),
+ and the expected_rev check is not atomic.
"""
return hass.data[DOMAIN].setdefault("write_lock", asyncio.Lock())
@@ -57,13 +57,13 @@ def _check_write(hass: HomeAssistant, connection) -> bool:
return connection.user.is_admin if admin_only else True
-# ---------------- раскладка ----------------
+# ---------------- layout ----------------
@websocket_api.websocket_command({vol.Required("type"): "houseplan/layout/get"})
@websocket_api.async_response
async def ws_layout_get(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
- """Вернуть сохранённую раскладку."""
+ """Return the saved layout."""
data = await _store(hass).async_load() or {}
connection.send_result(msg["id"], {"layout": data.get("layout", {})})
@@ -73,9 +73,9 @@ async def ws_layout_get(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
)
@websocket_api.async_response
async def ws_layout_set(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
- """Полностью заменить раскладку."""
+ """Replace the layout entirely."""
if not _check_write(hass, connection):
- connection.send_error(msg["id"], "unauthorized", "Правка раскладки разрешена только администраторам")
+ connection.send_error(msg["id"], "unauthorized", "Only administrators may edit the layout")
return
async with _write_lock(hass):
await _store(hass).async_save({"layout": msg["layout"]})
@@ -91,9 +91,9 @@ async def ws_layout_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
)
@websocket_api.async_response
async def ws_layout_update(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
- """Обновить позицию одного устройства."""
+ """Update the position of a single device."""
if not _check_write(hass, connection):
- connection.send_error(msg["id"], "unauthorized", "Правка раскладки разрешена только администраторам")
+ connection.send_error(msg["id"], "unauthorized", "Only administrators may edit the layout")
return
store = _store(hass)
async with _write_lock(hass):
@@ -112,9 +112,9 @@ async def ws_layout_update(hass: HomeAssistant, connection, msg: dict[str, Any])
)
@websocket_api.async_response
async def ws_layout_delete(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
- """Удалить позицию одного устройства (чистка при удалении маркера)."""
+ """Delete the position of a single device (cleanup when a marker is removed)."""
if not _check_write(hass, connection):
- connection.send_error(msg["id"], "unauthorized", "Правка раскладки разрешена только администраторам")
+ connection.send_error(msg["id"], "unauthorized", "Only administrators may edit the layout")
return
store = _store(hass)
async with _write_lock(hass):
@@ -126,13 +126,13 @@ async def ws_layout_delete(hass: HomeAssistant, connection, msg: dict[str, Any])
connection.send_result(msg["id"], {"ok": True})
-# ---------------- конфигурация пространств ----------------
+# ---------------- space configuration ----------------
@websocket_api.websocket_command({vol.Required("type"): "houseplan/config/get"})
@websocket_api.async_response
async def ws_config_get(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
- """Вернуть конфигурацию и её ревизию."""
+ """Return the configuration and its revision."""
data = await _config_store(hass).async_load() or {}
config = {**DEFAULT_CONFIG, **data.get("config", {})}
connection.send_result(msg["id"], {"config": config, "rev": data.get("rev", 0)})
@@ -147,14 +147,14 @@ async def ws_config_get(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
)
@websocket_api.async_response
async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
- """Заменить конфигурацию с оптимистичной блокировкой (expected_rev).
+ """Replace the configuration with optimistic locking (expected_rev).
- Защита от гонки нескольких открытых клиентов: если конфиг менялся с момента
- последнего чтения клиентом — возвращается ошибка conflict, клиент обязан
- перечитать конфиг и повторить правку поверх свежей версии.
+ Protects against races between several open clients: if the config has changed since
+ the client's last read — a conflict error is returned, and the client must
+ re-read the config and re-apply its edit on top of the fresh version.
"""
if not _check_write(hass, connection):
- connection.send_error(msg["id"], "unauthorized", "Правка конфигурации разрешена только администраторам")
+ connection.send_error(msg["id"], "unauthorized", "Only administrators may edit the configuration")
return
store = _config_store(hass)
async with _write_lock(hass):
@@ -163,7 +163,7 @@ async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
if "expected_rev" in msg and msg["expected_rev"] != current_rev:
connection.send_error(
msg["id"], "conflict",
- f"Конфигурация изменена в другом окне (rev {current_rev} != {msg['expected_rev']})",
+ f"Configuration was changed in another window (rev {current_rev} != {msg['expected_rev']})",
)
return
new_rev = current_rev + 1
@@ -172,7 +172,7 @@ async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
connection.send_result(msg["id"], {"ok": True, "rev": new_rev})
-# ---------------- загрузка планов ----------------
+# ---------------- plan uploads ----------------
@websocket_api.websocket_command(
@@ -185,21 +185,21 @@ async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
)
@websocket_api.async_response
async def ws_plan_set(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
- """Сохранить файл плана пространства; вернуть URL для карточки."""
+ """Save a space plan file; return the URL for the card."""
if not _check_write(hass, connection):
- connection.send_error(msg["id"], "unauthorized", "Загрузка планов разрешена только администраторам")
+ connection.send_error(msg["id"], "unauthorized", "Only administrators may upload plans")
return
space_id = msg["space_id"]
if not valid_space_id(space_id):
- connection.send_error(msg["id"], "invalid_space_id", "space_id: только [a-z0-9_-], до 64 символов")
+ connection.send_error(msg["id"], "invalid_space_id", "space_id: only [a-z0-9_-], up to 64 characters")
return
try:
raw = base64.b64decode(msg["data"], validate=True)
except (binascii.Error, ValueError):
- connection.send_error(msg["id"], "invalid_data", "data должен быть корректным base64")
+ connection.send_error(msg["id"], "invalid_data", "data must be valid base64")
return
if len(raw) > MAX_PLAN_BYTES:
- connection.send_error(msg["id"], "too_large", f"План больше {MAX_PLAN_BYTES // 1024 // 1024} МБ")
+ connection.send_error(msg["id"], "too_large", f"Plan is larger than {MAX_PLAN_BYTES // 1024 // 1024} MB")
return
plans_dir = Path(hass.config.path(PLANS_DIR))
@@ -207,7 +207,7 @@ async def ws_plan_set(hass: HomeAssistant, connection, msg: dict[str, Any]) -> N
def _write() -> int:
plans_dir.mkdir(parents=True, exist_ok=True)
- # убрать старые варианты с другим расширением
+ # remove old variants with a different extension
for old_ext in PLAN_EXTENSIONS:
old = plans_dir / f"{space_id}.{old_ext}"
if old_ext != msg["ext"] and old.exists():
diff --git a/dist/houseplan-card.js b/dist/houseplan-card.js
index 5499d40..d7f07c3 100755
--- a/dist/houseplan-card.js
+++ b/dist/houseplan-card.js
@@ -1,10 +1,10 @@
-const t=globalThis,e=t.ShadowRoot&&(void 0===t.ShadyCSS||t.ShadyCSS.nativeShadow)&&"adoptedStyleSheets"in Document.prototype&&"replace"in CSSStyleSheet.prototype,i=Symbol(),s=new WeakMap;let a=class{constructor(t,e,s){if(this._$cssResult$=!0,s!==i)throw Error("CSSResult is not constructable. Use `unsafeCSS` or `css` instead.");this.cssText=t,this.t=e}get styleSheet(){let t=this.o;const i=this.t;if(e&&void 0===t){const e=void 0!==i&&1===i.length;e&&(t=s.get(i)),void 0===t&&((this.o=t=new CSSStyleSheet).replaceSync(this.cssText),e&&s.set(i,t))}return t}toString(){return this.cssText}};const o=e?t=>t:t=>t instanceof CSSStyleSheet?(t=>{let e="";for(const i of t.cssRules)e+=i.cssText;return(t=>new a("string"==typeof t?t:t+"",void 0,i))(e)})(t):t,{is:n,defineProperty:r,getOwnPropertyDescriptor:l,getOwnPropertyNames:c,getOwnPropertySymbols:h,getPrototypeOf:d}=Object,p=globalThis,u=p.trustedTypes,_=u?u.emptyScript:"",g=p.reactiveElementPolyfillSupport,m=(t,e)=>t,f={toAttribute(t,e){switch(e){case Boolean:t=t?_:null;break;case Object:case Array:t=null==t?t:JSON.stringify(t)}return t},fromAttribute(t,e){let i=t;switch(e){case Boolean:i=null!==t;break;case Number:i=null===t?null:Number(t);break;case Object:case Array:try{i=JSON.parse(t)}catch(t){i=null}}return i}},v=(t,e)=>!n(t,e),b={attribute:!0,type:String,converter:f,reflect:!1,useDefault:!1,hasChanged:v};Symbol.metadata??=Symbol("metadata"),p.litPropertyMetadata??=new WeakMap;let y=class extends HTMLElement{static addInitializer(t){this._$Ei(),(this.l??=[]).push(t)}static get observedAttributes(){return this.finalize(),this._$Eh&&[...this._$Eh.keys()]}static createProperty(t,e=b){if(e.state&&(e.attribute=!1),this._$Ei(),this.prototype.hasOwnProperty(t)&&((e=Object.create(e)).wrapped=!0),this.elementProperties.set(t,e),!e.noAccessor){const i=Symbol(),s=this.getPropertyDescriptor(t,i,e);void 0!==s&&r(this.prototype,t,s)}}static getPropertyDescriptor(t,e,i){const{get:s,set:a}=l(this.prototype,t)??{get(){return this[e]},set(t){this[e]=t}};return{get:s,set(e){const o=s?.call(this);a?.call(this,e),this.requestUpdate(t,o,i)},configurable:!0,enumerable:!0}}static getPropertyOptions(t){return this.elementProperties.get(t)??b}static _$Ei(){if(this.hasOwnProperty(m("elementProperties")))return;const t=d(this);t.finalize(),void 0!==t.l&&(this.l=[...t.l]),this.elementProperties=new Map(t.elementProperties)}static finalize(){if(this.hasOwnProperty(m("finalized")))return;if(this.finalized=!0,this._$Ei(),this.hasOwnProperty(m("properties"))){const t=this.properties,e=[...c(t),...h(t)];for(const i of e)this.createProperty(i,t[i])}const t=this[Symbol.metadata];if(null!==t){const e=litPropertyMetadata.get(t);if(void 0!==e)for(const[t,i]of e)this.elementProperties.set(t,i)}this._$Eh=new Map;for(const[t,e]of this.elementProperties){const i=this._$Eu(t,e);void 0!==i&&this._$Eh.set(i,t)}this.elementStyles=this.finalizeStyles(this.styles)}static finalizeStyles(t){const e=[];if(Array.isArray(t)){const i=new Set(t.flat(1/0).reverse());for(const t of i)e.unshift(o(t))}else void 0!==t&&e.push(o(t));return e}static _$Eu(t,e){const i=e.attribute;return!1===i?void 0:"string"==typeof i?i:"string"==typeof t?t.toLowerCase():void 0}constructor(){super(),this._$Ep=void 0,this.isUpdatePending=!1,this.hasUpdated=!1,this._$Em=null,this._$Ev()}_$Ev(){this._$ES=new Promise(t=>this.enableUpdating=t),this._$AL=new Map,this._$E_(),this.requestUpdate(),this.constructor.l?.forEach(t=>t(this))}addController(t){(this._$EO??=new Set).add(t),void 0!==this.renderRoot&&this.isConnected&&t.hostConnected?.()}removeController(t){this._$EO?.delete(t)}_$E_(){const t=new Map,e=this.constructor.elementProperties;for(const i of e.keys())this.hasOwnProperty(i)&&(t.set(i,this[i]),delete this[i]);t.size>0&&(this._$Ep=t)}createRenderRoot(){const i=this.shadowRoot??this.attachShadow(this.constructor.shadowRootOptions);return((i,s)=>{if(e)i.adoptedStyleSheets=s.map(t=>t instanceof CSSStyleSheet?t:t.styleSheet);else for(const e of s){const s=document.createElement("style"),a=t.litNonce;void 0!==a&&s.setAttribute("nonce",a),s.textContent=e.cssText,i.appendChild(s)}})(i,this.constructor.elementStyles),i}connectedCallback(){this.renderRoot??=this.createRenderRoot(),this.enableUpdating(!0),this._$EO?.forEach(t=>t.hostConnected?.())}enableUpdating(t){}disconnectedCallback(){this._$EO?.forEach(t=>t.hostDisconnected?.())}attributeChangedCallback(t,e,i){this._$AK(t,i)}_$ET(t,e){const i=this.constructor.elementProperties.get(t),s=this.constructor._$Eu(t,i);if(void 0!==s&&!0===i.reflect){const a=(void 0!==i.converter?.toAttribute?i.converter:f).toAttribute(e,i.type);this._$Em=t,null==a?this.removeAttribute(s):this.setAttribute(s,a),this._$Em=null}}_$AK(t,e){const i=this.constructor,s=i._$Eh.get(t);if(void 0!==s&&this._$Em!==s){const t=i.getPropertyOptions(s),a="function"==typeof t.converter?{fromAttribute:t.converter}:void 0!==t.converter?.fromAttribute?t.converter:f;this._$Em=s;const o=a.fromAttribute(e,t.type);this[s]=o??this._$Ej?.get(s)??o,this._$Em=null}}requestUpdate(t,e,i,s=!1,a){if(void 0!==t){const o=this.constructor;if(!1===s&&(a=this[t]),i??=o.getPropertyOptions(t),!((i.hasChanged??v)(a,e)||i.useDefault&&i.reflect&&a===this._$Ej?.get(t)&&!this.hasAttribute(o._$Eu(t,i))))return;this.C(t,e,i)}!1===this.isUpdatePending&&(this._$ES=this._$EP())}C(t,e,{useDefault:i,reflect:s,wrapped:a},o){i&&!(this._$Ej??=new Map).has(t)&&(this._$Ej.set(t,o??e??this[t]),!0!==a||void 0!==o)||(this._$AL.has(t)||(this.hasUpdated||i||(e=void 0),this._$AL.set(t,e)),!0===s&&this._$Em!==t&&(this._$Eq??=new Set).add(t))}async _$EP(){this.isUpdatePending=!0;try{await this._$ES}catch(t){Promise.reject(t)}const t=this.scheduleUpdate();return null!=t&&await t,!this.isUpdatePending}scheduleUpdate(){return this.performUpdate()}performUpdate(){if(!this.isUpdatePending)return;if(!this.hasUpdated){if(this.renderRoot??=this.createRenderRoot(),this._$Ep){for(const[t,e]of this._$Ep)this[t]=e;this._$Ep=void 0}const t=this.constructor.elementProperties;if(t.size>0)for(const[e,i]of t){const{wrapped:t}=i,s=this[e];!0!==t||this._$AL.has(e)||void 0===s||this.C(e,void 0,i,s)}}let t=!1;const e=this._$AL;try{t=this.shouldUpdate(e),t?(this.willUpdate(e),this._$EO?.forEach(t=>t.hostUpdate?.()),this.update(e)):this._$EM()}catch(e){throw t=!1,this._$EM(),e}t&&this._$AE(e)}willUpdate(t){}_$AE(t){this._$EO?.forEach(t=>t.hostUpdated?.()),this.hasUpdated||(this.hasUpdated=!0,this.firstUpdated(t)),this.updated(t)}_$EM(){this._$AL=new Map,this.isUpdatePending=!1}get updateComplete(){return this.getUpdateComplete()}getUpdateComplete(){return this._$ES}shouldUpdate(t){return!0}update(t){this._$Eq&&=this._$Eq.forEach(t=>this._$ET(t,this[t])),this._$EM()}updated(t){}firstUpdated(t){}};y.elementStyles=[],y.shadowRootOptions={mode:"open"},y[m("elementProperties")]=new Map,y[m("finalized")]=new Map,g?.({ReactiveElement:y}),(p.reactiveElementVersions??=[]).push("2.1.2");const x=globalThis,$=t=>t,w=x.trustedTypes,k=w?w.createPolicy("lit-html",{createHTML:t=>t}):void 0,S="$lit$",C=`lit$${Math.random().toFixed(9).slice(2)}$`,A="?"+C,z=`<${A}>`,M=document,D=()=>M.createComment(""),P=t=>null===t||"object"!=typeof t&&"function"!=typeof t,E=Array.isArray,R="[ \t\n\f\r]",T=/<(?:(!--|\/[^a-zA-Z])|(\/?[a-zA-Z][^>\s]*)|(\/?$))/g,O=/-->/g,U=/>/g,H=RegExp(`>|${R}(?:([^\\s"'>=/]+)(${R}*=${R}*(?:[^ \t\n\f\r"'\`<>=]|("|')|))|$)`,"g"),I=/'/g,N=/"/g,q=/^(?:script|style|textarea|title)$/i,L=t=>(e,...i)=>({_$litType$:t,strings:e,values:i}),j=L(1),F=L(2),W=Symbol.for("lit-noChange"),B=Symbol.for("lit-nothing"),K=new WeakMap,V=M.createTreeWalker(M,129);function Z(t,e){if(!E(t)||!t.hasOwnProperty("raw"))throw Error("invalid template strings array");return void 0!==k?k.createHTML(e):e}const Y=(t,e)=>{const i=t.length-1,s=[];let a,o=2===e?"":3===e?"":"")),s]};class X{constructor({strings:t,_$litType$:e},i){let s;this.parts=[];let a=0,o=0;const n=t.length-1,r=this.parts,[l,c]=Y(t,e);if(this.el=X.createElement(l,i),V.currentNode=this.el.content,2===e||3===e){const t=this.el.content.firstChild;t.replaceWith(...t.childNodes)}for(;null!==(s=V.nextNode())&&r.length
- ${t.model?j`
`}_renderMarkerDialog(){const t=this._markerDialog,e="virtual"===t.binding,i=this._bindingCandidates(),s=(()=>{if(e)return null;const s=i.find(e=>e.value===t.binding);if(s)return s.label;const[a,o]=t.binding.split(":");return"device"===a?this.hass.devices[o]?.name_by_user||this.hass.devices[o]?.name||o:this.hass.states[o]?.attributes?.friendly_name||o})();return j``}_renderMarkerDialog(){const t=this._markerDialog,e="virtual"===t.binding,i=this._bindingCandidates(),s=(()=>{if(e)return null;const s=i.find(e=>e.value===t.binding);if(s)return s.label;const[a,o]=t.binding.split(":");return"device"===a?this.hass.devices[o]?.name_by_user||this.hass.devices[o]?.name||o:this.hass.states[o]?.attributes?.friendly_name||o})();return F`Модель${t.model}
`:B}
- ${i?j`Состояние${i}
`:B}
- ${vt(t.link)?j`Ссылка
+ ${t.model?F`
- ${this._t("info.model")}${t.model}
`:B}
+ ${i?F`${this._t("info.state")}${i}
`:B}
+ ${vt(t.link)?F`${this._t("info.link")}
${t.link}
`:B}
- ${t.description?j`${t.description}
`:B}
- ${t.pdfs&&t.pdfs.length?j`Инструкции
- ${t.pdfs.map(t=>j`
+ ${t.description?F`
${t.description}
`:B}
+ ${t.pdfs&&t.pdfs.length?F`${this._t("info.manuals")}
+ ${t.pdfs.map(t=>F`
`:B}
- ${t.model||i||t.link||t.description||t.pdfs&&t.pdfs.length?B:j`Нет дополнительной информации
`}
+ ${t.model||i||t.link||t.description||t.pdfs&&t.pdfs.length?B:F`${this._t("info.none")}
`}
- ${t.primary?j`
t.stopPropagation()}>
`}_renderRoomDialog(){const t=this._freeAreas;return j``}_renderRoomDialog(){const t=this._freeAreas;return F``}}Ot.properties={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},_markup:{state:!0},_tool:{state:!0},_path:{state:!0},_cursorPt:{state:!0},_areaSel:{state:!0},_nameSel:{state:!0},_roomDialog:{state:!0},_spaceDialog:{state:!0},_infoCard:{state:!0},_markerDialog:{state:!0},_zoom:{state:!0},_view:{state:!0}},Ot.styles=zt,customElements.get("houseplan-card")||customElements.define("houseplan-card",Ot),window.customCards=window.customCards||[],window.customCards.find(t=>"houseplan-card"===t.type)||window.customCards.push({type:"houseplan-card",name:"House Plan Card",description:"Интерактивный план дома: пространства, комнаты, устройства с живыми состояниями и drag-раскладкой."}),console.info("%c HOUSEPLAN-CARD %c v1.10.0 ","background:#3ea6ff;color:#04121f;font-weight:700","");
+ t.stopPropagation()}>
-
- ${this._t("marker.name_label")}
+ this._markerDialog={...t,name:e.target.value}} />
-
+
`}_renderSpaceDialog(){const t=this._spaceDialog;return j``}_renderSpaceDialog(){const t=this._spaceDialog;return F`
- ${e?B:j`this._markerDialog={...t,icon:e.detail.value||""}}> `:j`${this._t("marker.icon_label")}
+ ${customElements.get("ha-icon-picker")?F`this._markerDialog={...t,icon:e.detail.value||""}}> `:F`this._markerDialog={...t,icon:e.target.value}} />`}
-
- ${this._t("marker.model_label")}
+ this._markerDialog={...t,model:e.target.value}} />
-
+
this._markerDialog={...t,link:e.target.value}} />
-
-
-
+
-
- ${i.map(e=>j`
-
+
-
- ${customElements.get("ha-icon-picker")?j`F`
this._markerDialog={...t,binding:e.value}}>
${e.label}${e.sub}
`)}
- ${i.length?B:j`ничего не найдено
`}
+ ${i.length?B:F`${this._t("marker.nothing_found")}
`}
- ${t.pdfs.map(t=>j`this._removeMarkerPdf(t.url)}> `)}
- ${t.devId?j`
t.stopPropagation()}>
- t.stopPropagation()}>
-
- ${this._t("space.title_label")}
+ this._spaceDialog={...t,title:e.target.value}} />
-
+
- ${t.planFile?j`${t.planFile.name}`:t.planUrl?j`
`:j`нет подложки`}
+ ${t.planFile?F`${t.planFile.name}`:t.planUrl?F``:F`${this._t("space.no_plan")}`}
- ${"edit"===t.mode?j`
-
Пространств пока нет.
- ${this._serverStorage?j`Добавьте первое пространство и загрузите план этажа.
+${this._t("empty.no_spaces")}
+ ${this._serverStorage?F`${this._t("empty.add_first")}
`:j`Установите интеграцию House Plan и добавьте запись в «Устройства и службы».
`} +${this._t("empty.install")}
`}${this._toast}
`:B}
- ${this._toast}
`:B}
+
- ${t.map(t=>j`
- ${s.length} устр.
+ ${this._t("count.devices",{n:s.length})}
-
+
-
+ title=${this._t("title.zoom_reset")}>
- ${this._norm?j`
-
${this._roomDialog?this._renderRoomDialog():B}
${this._spaceDialog?this._renderSpaceDialog():B}
${this._markerDialog?this._renderMarkerDialog():B}
${this._infoCard?this._renderInfoCard():B}
- ${this._tip?j`
- ${this._tip.title}${this._tip.meta?j`${this._tip.meta}`:B}
- ${null!=this._tip.lqi?j`средний сигнал zigbee:
- ${this._tip.lqi}`:B}
+ ${this._tip?F`
+ ${null!=r?F`${r}°`:B}
+ ${null!=n?F`${n}`:B}
+
`}_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)]}_renderMarkupDefs(t){const e=this._gridPitch,i=.14*e;return j`
+ ${this._tip.title}${this._tip.meta?F`${this._tip.meta}`:B}
+ ${null!=this._tip.lqi?F`${this._t("tip.lqi")}
+ ${this._tip.lqi}`:B}
`:B}
- ${this._toast?j`${this._toast}
`:B}
+ ${this._toast?F`${this._toast}
`:B}
- `}_renderDevice(t,e){const i=this._pos(t),s=(i.x-e.x)/e.w*100,a=(i.y-e.y)/e.h*100,o=this._stateClass(t),n=this._liveTemp(t),r=this._config?.show_signal&&!t.virtual?$t(this.hass,t.entities):null;return j`this._clickDevice(e,t)}
- @mousemove=${e=>this._showTip(e,t.name,t.model+(null!=n?" · "+n+"°":"")+(null!=r?" · LQI "+r:""))}
+ @mousemove=${e=>this._showTip(e,t.name,t.model+(null!=r?" · "+r+"°":"")+(null!=n?" · LQI "+n:""))}
@mouseleave=${()=>this._tip=null}
@pointerdown=${e=>this._pointerDown(e,t)}
@pointermove=${e=>this._pointerMove(e,t)}
@pointerup=${e=>this._pointerUp(e,t)}
>
`}_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)]}_renderMarkupDefs(t){const e=this._gridPitch,i=.14*e;return F`
+ ${i.map((t,e)=>j`
this._infoCard=null}>
` в прямоугольник `FLOOR_BG_RECT`:
+- Base space: **1489×1053** ("pixels" of the old PNG render, 1 unit = 1 px).
+ All rooms, icon positions and floor viewBoxes live in it. DO NOT change without a layout migration.
+- Vector plans are inserted as `` into the `FLOOR_BG_RECT` rectangle:
- f1: scale **0.647**, offset **(490, 27)** → rect [490, 27, 774.2, 949.3]
- f2: scale **0.896**, offset **(351, 21)** → rect [351, 21, 1048.4, 961.4]
- - вычислено растровой корреляцией (cv2.matchTemplate по бинаризованным картам темноты)
- рендера SVG с эталонным PNG; точность ~1 px. Скрипты воспроизводимы (docs/DEVELOPMENT.md).
-- Комнаты (`ROOMS`) сняппены к внутренним граням стен (полуавто: поиск ближайшей «тёмной линии»
- по профилю + ручная доводка по overlay-рендерам).
+ - computed via raster correlation (cv2.matchTemplate on binarized darkness maps) of the
+ SVG render against the reference PNG; accuracy ~1 px. The scripts are reproducible (docs/DEVELOPMENT.md).
+- Rooms (`ROOMS`) are snapped to the inner faces of walls (semi-automatic: search for the nearest
+ "dark line" along the profile + manual fine-tuning against overlay renders).
-## Модель данных карточки (runtime)
+## Card data model (runtime)
-`DevItem`: id (device_id), name, model, area, floor, icon, entities[], primary (сущность для
-more-info по приоритету доменов), temp, members[] (группа ламп), link/linkPrimary (Z2M-группа).
+`DevItem`: id (device_id), name, model, area, floor, icon, entities[], primary (the entity used for
+more-info by domain priority), temp, members[] (light group), link/linkPrimary (Z2M group).
-Построение из реестров (`_buildDevices`), правила 1-в-1 из прототипа:
-- показываются только устройства с area из списка комнат;
-- скрываются: entry_type=service, интеграции из EXCLUDED_DOMAINS, model=Group, сцены, мосты,
- под-устройства myheat, дубли по «имя|area»;
-- **устройство с сущностью `lock.*` всегда получает `mdi:lock`** (TTLock-замки в реестре
- называются «Дом»/«Терраса»/«Кладовка» — по имени не распознать);
-- лампы (mdi:lightbulb) ≥2 в комнате схлопываются в группу `mdi:lightbulb-group`
- (клик → меню: вся группа + отдельные).
+Built from the registries (`_buildDevices`), rules carried over 1-to-1 from the prototype:
+- only devices with an area from the room list are shown;
+- hidden: entry_type=service, integrations from EXCLUDED_DOMAINS, model=Group, scenes, bridges,
+ myheat sub-devices, duplicates by "name|area";
+- **a device with a `lock.*` entity always gets `mdi:lock`** (TTLock locks in the registry
+ are named "Dom"/"Terrasa"/"Kladovka" [House/Terrace/Storeroom] — unrecognizable by name);
+- lamps (mdi:lightbulb) with ≥2 in a room collapse into a group `mdi:lightbulb-group`
+ (click → menu: the whole group + individual lamps).
-## Живые данные
+## Live data
-- Температура: сущность с device_class=temperature / °C / `_temperature$` → метка справа.
-- LQI (zigbee): среднее по `*_linkquality`-сущностям → метка под иконкой; цвет
- `lqiColor()`: ≤40 красный → ≥180 зелёный (hsl-градиент). Среднее по комнате — в тултипе комнаты.
-- Классы состояния иконки: on (жёлтый), open (оранжевый: cover/valve/lock/binary_sensor
- проблемных классов), unavail (прозрачность).
+- Temperature: an entity with device_class=temperature / °C / `_temperature$` → label on the right.
+- LQI (zigbee): the average over `*_linkquality` entities → label under the icon; color via
+ `lqiColor()`: ≤40 red → ≥180 green (hsl gradient). The room average is shown in the room tooltip.
+- Icon state classes: on (yellow), open (orange: cover/valve/lock/binary_sensor
+ of problem classes), unavail (transparency).
-## Размеры
+## Sizes
-`icon_size` в конфиге = **% ширины видимой области плана** (дефолт 2.5). Реализация:
-`.stage { container-type: inline-size }` + размеры в `cqw`. Легаси px-значения (>8) игнорируются.
+`icon_size` in the config = **% of the visible plan area width** (default 2.5). Implementation:
+`.stage { container-type: inline-size }` + sizes in `cqw`. Legacy px values (>8) are ignored.
-## Sticky-шапка
+## Sticky header
-`.head { position: sticky; top: var(--header-height, 56px) }`; ОБЯЗАТЕЛЬНО
-`ha-card { overflow: visible }` — `overflow: hidden` ломает sticky.
+`.head { position: sticky; top: var(--header-height, 56px) }`; it is MANDATORY that
+`ha-card { overflow: visible }` — `overflow: hidden` breaks sticky.
-## Маркеры устройств (v1.6.0+)
+## Device markers (v1.6.0+)
`config.markers[]`: `{id, binding:'device:'|'entity:'|'virtual', space?, area?, hidden?,
-name?, icon?, model?, link?, description?, pdfs:[{name,url}]}`. Гибрид: авто-устройства HA
-появляются сами; маркер с `binding=device:` их перекрывает (метаданные/перепривязка/скрытие),
-`entity:` — для групп/хелперов, `virtual` — ручной значок без HA. id маркера = device_id /
-`lg_` / `v_` (сохраняет позицию в layout). Пикер привязки исключает уже размещённые
-ссылки и дубли по имя|area. Файлы-инструкции: `houseplan/file/set` → `/config/houseplan/files//`,
-отдача `/houseplan_files/files/`.
+name?, icon?, model?, link?, description?, pdfs:[{name,url}]}`. A hybrid: auto-discovered HA devices
+appear on their own; a marker with `binding=device:` overrides them (metadata/rebinding/hiding),
+`entity:` — for groups/helpers, `virtual` — a manual icon without HA. The marker id = device_id /
+`lg_` / `v_` (preserves the position in the layout). The binding picker excludes already-placed
+references and duplicates by name|area. Manual files: `houseplan/file/set` → `/config/houseplan/files//`,
+served from `/houseplan_files/files/`.
-## Серверная конфигурация (v1.3.0+)
+## Server-side configuration (v1.3.0+)
`.storage/houseplan.config` (Store):
```json
@@ -104,31 +104,31 @@ name?, icon?, model?, link?, description?, pdfs:[{name,url}]}`. Гибрид: а
"virtual_devices": [{"id","space","name","icon","x","y","note?","entity_id?"}],
"settings": {"exclude_integrations":[],"group_lights":true} }
```
-Все координаты **нормированные (0..1 от плана пространства)**; рендер-пространство
-1000 × 1000/aspect. Раскладка v2: `{device_id: {"s": space, "x", "y"}}` (нормир.).
-Файлы планов: `/houseplan/plans/.` → URL `/houseplan_files/plans/…`.
-Если server config пуст — карточка работает от legacy-бандла (дача) и показывает кнопку
-миграции «На сервер» в режиме правки. Дача мигрирована 2026-07-04.
+All coordinates are **normalized (0..1 of the space plan)**; the render space is
+1000 × 1000/aspect. Layout v2: `{device_id: {"s": space, "x", "y"}}` (normalized).
+Plan files: `/houseplan/plans/.` → URL `/houseplan_files/plans/…`.
+If the server config is empty, the card falls back to the legacy bundle (the dacha) and shows a
+"To server" migration button in edit mode. The dacha was migrated on 2026-07-04.
-## Редактор разметки (v1.4.0+)
+## Markup editor (v1.4.0+)
-Состояние в карточке: `_markup` (режим), `_tool` (draw/erase/delroom), `_path` (текущий контур,
-вершины по сетке GRID_N=60). Клики по stage → `_svgPoint`→`_snap`. Каждая пара точек добавляет
-сегмент в `space.segments` (дедуп по ключу, сохранение config/set с дебаунсом). Контур замкнут
-= клик по первой вершине → селект зоны (hass.areas) + имя → room {poly}. Комнаты-полигоны и
-прямоугольники рендерятся единообразно (hit-test: point-in-polygon / rect).
+State inside the card: `_markup` (mode), `_tool` (draw/erase/delroom), `_path` (the current outline,
+vertices on the GRID_N=60 grid). Clicks on the stage → `_svgPoint`→`_snap`. Each pair of points adds a
+segment to `space.segments` (dedup by key, saved via config/set with debounce). The outline is closed
+= a click on the first vertex → area select (hass.areas) + name → room {poly}. Polygon rooms and
+rectangles are rendered uniformly (hit-test: point-in-polygon / rect).
-## WS API интеграции
+## Integration WS API
-| Команда | Параметры | Ответ |
+| Command | Parameters | Response |
|---|---|---|
| `houseplan/layout/get` | — | `{layout: {device_id: {x,y}}}` |
-| `houseplan/layout/set` | `layout` | `{ok}` (admin_only опционально) |
+| `houseplan/layout/set` | `layout` | `{ok}` (admin_only optional) |
| `houseplan/layout/update` | `device_id`, `pos` | `{ok}` |
| `houseplan/config/get` | — | `{config, rev}` |
-| `houseplan/config/set` | `config`, `expected_rev?` | `{ok, rev}` / err `conflict`; событие `houseplan_config_updated` |
-| `houseplan/plan/set` | `space_id`, `ext` (svg/png/jpg/webp), `data` (b64, ≤8МБ) | `{ok, url}` |
-| `houseplan/file/set` | `marker_id`, `filename`, `data` (b64) | `{ok,url,name}` (legacy, лимит WS) |
+| `houseplan/config/set` | `config`, `expected_rev?` | `{ok, rev}` / err `conflict`; event `houseplan_config_updated` |
+| `houseplan/plan/set` | `space_id`, `ext` (svg/png/jpg/webp), `data` (b64, ≤8 MB) | `{ok, url}` |
+| `houseplan/file/set` | `marker_id`, `filename`, `data` (b64) | `{ok,url,name}` (legacy, WS limit) |
-**Загрузка файлов — HTTP** (не WS, у него лимит размера сообщения): `POST /api/houseplan/upload`
-(multipart: marker_id + file), HomeAssistantView, requires_auth. Отдача — `/houseplan_files/files/`.
+**File uploads go over HTTP** (not WS, which has a message-size limit): `POST /api/houseplan/upload`
+(multipart: marker_id + file), HomeAssistantView, requires_auth. Served from `/houseplan_files/files/`.
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 72dba0a..7e6f8bd 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,310 +1,328 @@
# Changelog
-## v1.10.0 — 2026-07-05 (аудит: гонки записи, XSS, модульность)
-**Бэкенд**
-- **Гонка записи устранена**: все циклы load→modify→save (`layout/set|update|delete`,
- `config/set`) сериализованы общим `asyncio.Lock` — параллельные WS-вызовы больше не теряют
- изменения, проверка `expected_rev` стала атомарной.
-- Новая WS-команда `houseplan/layout/delete` — чистка позиции при удалении маркера
- (раньше в `.storage/houseplan.layout` копились сироты).
-- Удалена мёртвая WS-команда `houseplan/file/set` — файлы грузятся только по HTTP
- (`/api/houseplan/upload`), как и было в карточке.
-- HTTP-загрузка: лимит 25 МБ применяется ПО МЕРЕ чтения multipart (обрыв на лимите),
- а не после чтения всего файла в память; `stat()` файлов ушёл в executor.
-- `request.app[KEY_HASS]` вместо устаревшего `request.app["hass"]` (с фолбэком для старых HA).
+## v1.11.0 — 2026-07-05 (full English translation + UI localization)
+- **UI localization (en/ru)**: every card string moved to `src/i18n.ts` dictionaries.
+ The language follows the HA user profile (`hass.locale`) automatically; a new
+ `language: en|ru` card option forces it. The GUI editor got the option and its own
+ localized labels. Generated device names (light group, unnamed, virtual device)
+ are localized via a `loc` callback in `BuildCtx`.
+- **English-only codebase**: all comments, docstrings, section banners, JSDoc, test
+ names, backend WS/HTTP error messages and log lines translated to English.
+ Russian remains only where it is functional or content: the `ru` i18n dictionary,
+ `translations/ru.json` (config flow), `iconFor` regex patterns matching Russian
+ device names (with their test fixtures), and the Russian documentation copy.
+- **Docs**: README is now English-first with a full Russian copy in `README.ru.md`;
+ `docs/ARCHITECTURE.md`, `DEVELOPMENT.md`, `ROADMAP.md` and the entire CHANGELOG
+ history translated to English. `translations/en.json` had Russian strings — fixed.
+- Removed obsolete `RELEASE_NOTES_v1.9.3.md` and `scripts_publish.sh` (publication
+ is done; the repo lives at github.com/Matysh/houseplan-card).
-**Фронтенд**
-- **God-component разобран**: `houseplan-card.ts` 3023 → ~1990 строк.
- Стили → `styles.ts`; типы → `types.ts`; построение устройств из реестров HA
- (курирование, группы света, маркеры, LQI/температура) → `devices.ts` (чистые функции).
-- **Last-writer-wins в раскладке устранён**: `_saveMarker` пишет позицию точечно
- (`layout/update`), а не всей раскладкой (`layout/set`) — не затирает позиции из других
- окон (регресс-класс инцидента v1.4.4). Перепривязка/удаление подчищают старую позицию.
-- **XSS закрыт**: `link` и `pdfs[].url` маркеров проходят `safeUrl()` (только http(s)
- и относительные пути; `javascript:`/`data:` отбрасываются). +12 тестов.
-- Загрузка файлов через `hass.fetchWithAuth` (автообновление протухшего токена),
- фолбэк на сырой токен.
-- **Хардкод дачи убран из GUI-редактора**: список «пространство по умолчанию» строится
- из серверного конфига (WS `config/get`), а не зашитых f1/f2/yard.
-- `rules.ts`: удалён мёртвый экспорт `GROUP_TITLES`; регэкспы `iconFor` прекомпилированы.
-- Единый `_errText()` во всех обработчиках ошибок (никогда «[object Object]»).
+## v1.10.0 — 2026-07-05 (audit: write races, XSS, modularity)
+**Backend**
+- **Write race eliminated**: all load→modify→save cycles (`layout/set|update|delete`,
+ `config/set`) are serialized by a shared `asyncio.Lock` — concurrent WS calls no longer lose
+ changes, and the `expected_rev` check became atomic.
+- New WS command `houseplan/layout/delete` — cleans up a position when a marker is deleted
+ (previously orphans accumulated in `.storage/houseplan.layout`).
+- Removed the dead WS command `houseplan/file/set` — files are uploaded over HTTP only
+ (`/api/houseplan/upload`), as the card already did.
+- HTTP upload: the 25 MB limit is enforced WHILE reading the multipart stream (abort at the limit),
+ not after reading the whole file into memory; file `stat()` moved into the executor.
+- `request.app[KEY_HASS]` instead of the deprecated `request.app["hass"]` (with a fallback for older HA).
-## v1.9.3 — 2026-07-05 (аудит + рефакторинг + тесты)
-- Чистые функции `fitView` (contain-прямоугольник вьюпорта) и `declump` (расталкивание значков)
- вынесены из карточки в `logic.ts` — покрыты юнит-тестами (было 9 → стало 14 тестов).
-- `_lqiFor` и `_roomLqi` теперь используют общую `averageLqi` (убрано дублирование усреднения).
-- Удалён мёртвый код после отказа от отдельного режима правки: поле `_edit` (писалось, но не
- читалось), методы `_renderEditbar` и `_applyXY` (не вызывались).
-- Поведение не изменилось — только структура и покрытие тестами. Проверено: tsc, сборка,
- 14 фронт-тестов + 10 бэк-тестов зелёные, headless-дымтест (рендер/зум/устройства/declump) чист.
+**Frontend**
+- **The god-component was broken up**: `houseplan-card.ts` 3023 → ~1990 lines.
+ Styles → `styles.ts`; types → `types.ts`; building devices from the HA registries
+ (curation, light groups, markers, LQI/temperature) → `devices.ts` (pure functions).
+- **Last-writer-wins in the layout eliminated**: `_saveMarker` writes the position pointwise
+ (`layout/update`), not the whole layout (`layout/set`) — it no longer wipes positions from other
+ windows (the regression class of the v1.4.4 incident). Rebinding/deletion clean up the old position.
+- **XSS closed**: marker `link` and `pdfs[].url` go through `safeUrl()` (only http(s)
+ and relative paths; `javascript:`/`data:` are rejected). +12 tests.
+- File uploads via `hass.fetchWithAuth` (auto-refresh of an expired token),
+ fallback to the raw token.
+- **The dacha hardcode removed from the GUI editor**: the "default space" list is built
+ from the server config (WS `config/get`), not the baked-in f1/f2/yard.
+- `rules.ts`: removed the dead export `GROUP_TITLES`; the `iconFor` regexes are precompiled.
+- A single `_errText()` in all error handlers (never "[object Object]").
-## v1.9.2 — 2026-07-05 (сетка вдвое мельче)
-- Шаг сетки разметки/привязки уменьшен вдвое: `GRID_N` 120 → 240. Позиции устройств и контуры
- комнат НЕ пересчитываются и не сдвигаются: координаты хранятся нормированными долями и снапятся
- к узлам сетки, а старые узлы (кратные 1/120) — точное подмножество новых (кратных 1/240).
- Проверено на живой раскладке (65 позиций — все уже на новой сетке). Перетаскивание теперь
- позволяет более точное позиционирование.
+## v1.9.3 — 2026-07-05 (audit + refactoring + tests)
+- The pure functions `fitView` (viewport contain rectangle) and `declump` (icon push-apart)
+ were extracted from the card into `logic.ts` — covered by unit tests (was 9 → now 14 tests).
+- `_lqiFor` and `_roomLqi` now use the shared `averageLqi` (duplicate averaging removed).
+- Removed dead code left after dropping the separate edit mode: the `_edit` field (written but
+ never read), the methods `_renderEditbar` and `_applyXY` (never called).
+- No behavior change — only structure and test coverage. Verified: tsc, build,
+ 14 frontend tests + 10 backend tests green, headless smoke test (render/zoom/devices/declump) clean.
-## v1.9.1 — 2026-07-05 (сигнал Zigbee: чтение из атрибута + ZHA)
-- Уровень сигнала теперь берётся не только из выделенного сенсора `*_linkquality` (Z2M), но и:
- из сенсоров `*_lqi` (ZHA), и из АТРИБУТА `linkquality`/`lqi` на любой сущности устройства.
- Это покрывает устройства, у которых отдельный сенсор сигнала отключён, но значение есть в атрибуте.
-- ПРИМЕЧАНИЕ: если у устройства сенсор `*_linkquality` отключён (disabled_by=integration) И значение
- нигде не публикуется как атрибут — сигнал показать нельзя, нужно включить сенсор в реестре HA.
+## v1.9.2 — 2026-07-05 (grid twice as fine)
+- The markup/snapping grid step was halved: `GRID_N` 120 → 240. Device positions and room
+ outlines are NOT recomputed and do not shift: coordinates are stored as normalized fractions and snap
+ to grid nodes, and the old nodes (multiples of 1/120) are an exact subset of the new ones (multiples of 1/240).
+ Verified on the live layout (65 positions — all already on the new grid). Dragging now
+ allows more precise positioning.
-## v1.9.0 — 2026-07-05 (UX: перетаскивание всегда, расталкивание, показать все, адаптив)
-- **Перетаскивание значков доступно всегда** — отдельный «режим правки» убран (кнопка ✥ удалена).
- Клик по значку открывает карточку устройства (правка метаданных — через кнопку «Редактировать»
- в ней), перетаскивание работает в любой момент. `_pointerDown` больше не требует `_edit`.
-- **Значки не скучиваются** (`_declump`): после авто-раскладки по сетке выполняется расталкивание
- в пределах комнаты, чтобы иконки не налезали друг на друга.
-- **Позиции фиксируются при сохранении комнаты**: авто-позиции устройств зоны один раз пишутся
- в раскладку, поэтому при смене порядка в реестре HA значки не перетасовываются.
-- **Дубли не скрываются, а нумеруются**: устройства с одинаковым «имя|зона» получают суффикс
- (« 2», « 3»…) вместо тихого исчезновения.
-- **Кнопка 👁 «Показать все устройства»** в шапке: временно отключает курирование и показывает
- все устройства зоны (мосты, служебные, дубли) — на случай, если нужное скрыто. Флаг `show_all`
- в настройках конфига.
-- **Подсказка продолжения разметки**: после сохранения комнаты тост показывает счётчик комнат и
- предлагает обвести следующую или выйти из разметки.
-- **Адаптивная шапка**: тулбар переносится и ужимается на узких экранах (media-query ≤620px).
+## v1.9.1 — 2026-07-05 (Zigbee signal: reading from the attribute + ZHA)
+- The signal level is now taken not only from the dedicated `*_linkquality` sensor (Z2M), but also:
+ from `*_lqi` sensors (ZHA), and from the `linkquality`/`lqi` ATTRIBUTE on any entity of the device.
+ This covers devices whose dedicated signal sensor is disabled but the value is available in an attribute.
+- NOTE: if a device's `*_linkquality` sensor is disabled (disabled_by=integration) AND the value
+ is not published anywhere as an attribute — the signal cannot be shown; enable the sensor in the HA registry.
-## v1.8.4 — 2026-07-04 (онбординг: обязательные поля + ведение пользователя)
-- Первичная инициализация приведена к целевому сценарию: установка → диалог пространства →
- комнаты → авто-значки устройств.
-- **Подложка обязательна** при создании пространства: «Сохранить» неактивна без загруженного
- плана (раньше требовалось только название — можно было создать пустое пространство).
-- **Зона комнаты обязательна** с явным выходом: основная «Сохранить» требует привязку к зоне HA;
- для декоративных комнат без устройств (холл, сауна) есть отдельная кнопка «Без зоны»
- (нужно только имя). Раньше сохранить можно было по «имя ИЛИ зона».
-- **Ведение пользователя:** на пустом серверном конфиге диалог пространства открывается
- автоматически; после добавления первого пространства карточка сама входит в режим разметки
- комнат с подсказкой «обведите комнаты».
-- При сохранении комнаты с зоной значки устройств этой зоны авто-расставляются внутри контура
- (курируемый набор: без мостов/служебных/дублей/одиночных ламп из групп), тост показывает,
- сколько устройств добавлено.
+## v1.9.0 — 2026-07-05 (UX: always-on dragging, declumping, show all, responsive)
+- **Icon dragging is available at all times** — the separate "edit mode" is gone (the ✥ button removed).
+ Clicking an icon opens the device card (metadata editing — via the "Edit" button
+ inside it), dragging works at any moment. `_pointerDown` no longer requires `_edit`.
+- **Icons no longer clump together** (`_declump`): after the automatic grid layout a push-apart pass
+ runs within the room so that icons do not overlap each other.
+- **Positions are pinned when a room is saved**: the auto-positions of the area's devices are written
+ into the layout once, so icons do not get reshuffled when the order in the HA registry changes.
+- **Duplicates are numbered instead of hidden**: devices with the same "name|area" get a suffix
+ (" 2", " 3"…) instead of silently disappearing.
+- **The 👁 "Show all devices" button** in the header: temporarily disables curation and shows
+ all devices of the area (bridges, service records, duplicates) — in case a needed one is hidden. The `show_all`
+ flag in the config settings.
+- **Markup continuation hint**: after saving a room a toast shows the room counter and
+ suggests outlining the next one or leaving markup mode.
+- **Responsive header**: the toolbar wraps and shrinks on narrow screens (media query ≤620px).
-## v1.8.3 — 2026-07-04 (мгновенный старт: кэш конфига, данные в фоне)
-- Иконки и план появлялись с задержкой — карточка ждала ответа сервера (WS `config/get`
- + ретраи прогрева соединения), до этого модель пространств была пуста.
-- Внедрён кэш «stale-while-revalidate»: снимок серверного конфига + rev + раскладки
- сохраняется в `localStorage['houseplan_card_cfg_v1']`. В `setConfig` (синхронно, до прихода
- hass) он восстанавливается — план и значки рисуются сразу из кэша (проверено: setConfig
- наполняет модель за 0.2 мс без сервера), а свежие данные догружаются в фоне и обновляют
- карточку. Живые состояния/температуры/сигнал подтягиваются по мере прогрева hass.
-- Кэш обновляется после каждой успешной загрузки, live-ресинка и сохранения позиций иконок,
- поэтому при следующем открытии виден актуальный снимок. При недоступном сервере показывается
- последний известный план вместо пустого онбординга.
+## v1.8.4 — 2026-07-04 (onboarding: required fields + user guidance)
+- Initial setup brought to the target scenario: install → space dialog →
+ rooms → auto device icons.
+- **The background is mandatory** when creating a space: "Save" stays disabled without an uploaded
+ plan (previously only the name was required — an empty space could be created).
+- **The room area is mandatory**, with an explicit escape hatch: the main "Save" requires binding to an HA area;
+ for decorative rooms without devices (hall, sauna) there is a separate "No area" button
+ (only a name is needed). Previously saving was possible with "name OR area".
+- **User guidance:** with an empty server config the space dialog opens
+ automatically; after the first space is added the card enters room markup mode
+ by itself with an "outline the rooms" hint.
+- When a room with an area is saved, the icons of that area's devices are auto-placed inside the outline
+ (the curated set: without bridges/service records/duplicates/individual lamps from groups), and a toast shows
+ how many devices were added.
-## v1.8.2 — 2026-07-04 (векторно-чёткий зум через viewBox + полная ширина сцены)
-- Зум переведён с CSS `transform: scale()` на манипуляцию `viewBox` SVG. Раньше слой
- растрировался и потом масштабировался — при приближении всё «мылилось». Теперь браузер
- перерисовывает вектор в целевом разрешении: иконки, подписи комнат, линии, штриховка и
- векторная подложка остаются чёткими на любом масштабе (проверено на 274%).
-- Слой иконок (HTML) позиционируется и масштабируется по тому же `view`, а не общим
- transform — иконки чёткие и растут вместе с планом.
-- Сцена теперь занимает всю ширину вьюпорта (модель «contain» по аспекту сцены): при
- зум-ине контент заполняет ширину без чёрных полей по бокам. При полном отдалении виден
- весь план (по ширине и высоте), поля вокруг залиты фоном карточки, а не чёрным.
-- Вся координатная математика (клик разметки `_svgPoint`, drag иконок, pan, pinch) переписана
- в единых `view`-координатах — редактирование корректно на любом зуме. ResizeObserver сцены
- пересчитывает `view` при изменении размеров (сайдбар, поворот). Пан/зум ограничены `fit`.
+## v1.8.3 — 2026-07-04 (instant start: config cache, data in the background)
+- Icons and the plan appeared with a delay — the card waited for the server response (WS `config/get`
+ + connection warm-up retries), and until then the space model was empty.
+- A "stale-while-revalidate" cache was introduced: a snapshot of the server config + rev + layout
+ is saved in `localStorage['houseplan_card_cfg_v1']`. In `setConfig` (synchronously, before
+ hass arrives) it is restored — the plan and icons are drawn immediately from the cache (verified: setConfig
+ populates the model in 0.2 ms without the server), while fresh data loads in the background and updates the
+ card. Live states/temperatures/signal come in as hass warms up.
+- The cache is refreshed after every successful load, live resync and icon position save,
+ so on the next open the current snapshot is visible. When the server is unavailable the
+ last known plan is shown instead of the empty onboarding.
-## v1.8.1 — 2026-07-04 (fit-to-viewport + сохранение зума по пространствам)
-- Уменьшение масштаба до полного вида: нижний предел зума = 100% совпадает с полностью
- видимым планом. `.stage` теперь ограничена по высоте вьюпорта
- (`width:min(100%, calc((100dvh − 118px) × aspect))`, `max-width:100%`, центрирование),
- поэтому при сбросе/зум-ауте вся схема видна и по ширине, и по высоте без обрезки.
-- Масштаб запоминается для каждого пространства отдельно и локально на устройстве
- (`localStorage['houseplan_card_zoom_v1']`, `_zoomBySpace`): переключение этажей
- восстанавливает свой зум; при возврате пан центрируется и ограничивается.
-- Проверено на живом HA: f1→196%, f2→140%, двор нетронут — после переключений
- значения восстанавливаются; сброс даёт 100% и полный план (874≤992 px по высоте).
+## v1.8.2 — 2026-07-04 (vector-crisp zoom via viewBox + full-width stage)
+- Zoom moved from CSS `transform: scale()` to manipulating the SVG `viewBox`. Previously the layer
+ was rasterized and then scaled — everything "blurred" when zooming in. Now the browser
+ redraws the vector at the target resolution: icons, room labels, lines, hatching and the
+ vector background remain crisp at any scale (verified at 274%).
+- The icon layer (HTML) is positioned and scaled by the same `view`, not a global
+ transform — the icons are crisp and grow together with the plan.
+- The stage now occupies the full viewport width (a "contain" model by the stage aspect): when
+ zoomed in the content fills the width without black bars on the sides. Fully zoomed out the
+ whole plan is visible (both width and height), the margins around it are filled with the card
+ background, not black.
+- All coordinate math (markup click `_svgPoint`, icon drag, pan, pinch) was rewritten
+ in unified `view` coordinates — editing is correct at any zoom. A ResizeObserver on the stage
+ recomputes the `view` when dimensions change (sidebar, rotation). Pan/zoom are constrained to `fit`.
+
+## v1.8.1 — 2026-07-04 (fit-to-viewport + per-space zoom persistence)
+- Zooming out to the full view: the lower zoom limit = 100% coincides with the fully
+ visible plan. `.stage` is now constrained by the viewport height
+ (`width:min(100%, calc((100dvh − 118px) × aspect))`, `max-width:100%`, centering),
+ so on reset/zoom-out the whole layout is visible both in width and height without clipping.
+- The zoom level is remembered per space and locally per device
+ (`localStorage['houseplan_card_zoom_v1']`, `_zoomBySpace`): switching floors
+ restores each floor's zoom; on return the pan is centered and constrained.
+- Verified on live HA: f1→196%, f2→140%, the yard untouched — after switching around the
+ values are restored; reset gives 100% and the full plan (874≤992 px in height).
-## v1.8.0 — 2026-07-04 (зумирование плана)
-- Зум и панорама схемы: колёсико мыши (к курсору), щипок двумя пальцами (pinch) на тач-экране,
- перетаскивание фона одним пальцем при увеличении, кнопки −/сброс/+ в тулбаре, бейдж масштаба.
-- Реализовано через CSS-transform на `.zoomwrap` (translate+scale); координатная математика
- (клик разметки, drag иконок, тултипы) пересчитана с учётом зума/пана — редактирование
- работает и при увеличении. Пан ограничен, чтобы контент всегда покрывал сцену. Зум 100–800%.
-- `.stage`: overflow hidden + touch-action none (свои жесты вместо браузерных).
+## v1.8.0 — 2026-07-04 (plan zooming)
+- Zoom and pan of the layout: mouse wheel (towards the cursor), two-finger pinch on a touch screen,
+ one-finger background drag when zoomed in, −/reset/+ buttons in the toolbar, a zoom badge.
+- Implemented via a CSS transform on `.zoomwrap` (translate+scale); the coordinate math
+ (markup clicks, icon drag, tooltips) was recomputed with zoom/pan in mind — editing
+ works when zoomed in too. Pan is constrained so the content always covers the stage. Zoom 100–800%.
+- `.stage`: overflow hidden + touch-action none (custom gestures instead of the browser's).
-## v1.7.4 — 2026-07-04 (PDF по HTTP вместо WebSocket)
-- КОРНЕВАЯ ПРИЧИНА невозможности загрузить PDF: файл слался как base64 одним WebSocket-сообщением,
- а у WS есть лимит размера — реальный мануал (>2–3 МБ) превышал его, соединение рвалось
- («Connection lost»), из-за чего и падала загрузка, и закрывался диалог (обрыв WS → переподключение
- → ре-рендер). Подтверждено тестом: 1 МБ по WS ок, 3 МБ → Connection lost.
-- Файлы-инструкции теперь грузятся через HTTP-эндпоинт `POST /api/houseplan/upload` (multipart,
- HomeAssistantView, requires_auth, admin_only-проверка) — как медиа в самом HA. Проверено:
- 3 МБ (182мс) и 10 МБ (446мс) загружаются на ура.
-- Читаемые ошибки везде (`_errText`): больше никаких «[object Object]»; понятные тексты для
+## v1.7.4 — 2026-07-04 (PDF over HTTP instead of WebSocket)
+- THE ROOT CAUSE of being unable to upload a PDF: the file was sent as base64 in a single WebSocket
+ message, and WS has a message-size limit — a real manual (>2–3 MB) exceeded it, the connection dropped
+ ("Connection lost"), which both failed the upload and closed the dialog (WS drop → reconnect
+ → re-render). Confirmed by test: 1 MB over WS is fine, 3 MB → Connection lost.
+- Manual files are now uploaded through the HTTP endpoint `POST /api/houseplan/upload` (multipart,
+ HomeAssistantView, requires_auth, admin_only check) — like media in HA itself. Verified:
+ 3 MB (182 ms) and 10 MB (446 ms) upload without a hitch.
+- Readable errors everywhere (`_errText`): no more "[object Object]"; clear texts for
too_large / bad_ext / unauthorized.
-- WS-команда houseplan/file/set оставлена для совместимости, но фронт использует HTTP.
+- The WS command houseplan/file/set is kept for compatibility, but the frontend uses HTTP.
-## v1.7.3 — 2026-07-04 (фиксы диалога устройства)
-- PDF-инструкции не загружались: ручной base64 (`btoa(String.fromCharCode(...subarray))`) падал
- на реальных файлах (RangeError при спреде больших массивов), а при закрытии диалога во время
- await бросал null-доступ. Заменено на `FileReader.readAsDataURL` (надёжно для любого размера),
- результаты аккумулируются и добавляются, только если диалог ещё открыт (без исключений).
-- Диалог редактирования устройства/пространства/комнаты закрывался по клику мимо и «сам»
- (случайный клик по фон-оверлею, в т.ч. после закрытия системного выбора файла). Убрано
- закрытие по клику на фон у диалогов-редакторов — только явные Отмена/Сохранить/Esc.
- Инфо-карточка (только чтение) по-прежнему закрывается кликом мимо.
-- Проверено на живом HA: PDF прикрепляется; клик по фону и обновление данных диалог не закрывают.
+## v1.7.3 — 2026-07-04 (device dialog fixes)
+- PDF manuals failed to upload: the manual base64 (`btoa(String.fromCharCode(...subarray))`) crashed
+ on real files (RangeError when spreading large arrays), and when the dialog was closed during an
+ await it threw a null access. Replaced with `FileReader.readAsDataURL` (reliable for any size);
+ the results are accumulated and added only if the dialog is still open (no exceptions).
+- The device/space/room edit dialog closed on an outside click and "by itself"
+ (an accidental click on the background overlay, including after closing the system file picker). Removed
+ background-click closing for editor dialogs — only explicit Cancel/Save/Esc.
+ The info card (read-only) still closes on an outside click.
+- Verified on live HA: PDFs attach; a background click and dialog data refresh do not close the dialog.
-## v1.7.2 — 2026-07-04 (фикс мобильного «ошибка конфигурации»)
-- ПРИЧИНА: карточка подключалась только через `add_extra_js_url` (extra_module_url), загрузку
- которого фронтенд НЕ дожидается — на холодном старте мобильного приложения дашборд рисовался
- раньше регистрации элемента → «ошибка конфигурации». (Все рабочие HACS-карточки — Lovelace-ресурсы.)
-- ФИКС 1: интеграция регистрирует карточку как **Lovelace-ресурс** (module) — их фронтенд ждёт
- перед рендером. Идемпотентно (обновляет URL при смене версии, без дублей); фолбэк на
- extra_module_url для YAML-режима Lovelace. `_register_lovelace_resource` в __init__.py.
-- ФИКС 2: `_loadFromServer` ретраит (до 8 попыток по обновлениям hass) — если hass пришёл раньше
- готовности WS, карточка не застревает на онбординге, а дожидается конфига.
-- Проверено: ресурс houseplan-card.js зарегистрирован, extra_module_url пуст (единый чистый
- модуль), карточка рендерит план на свежей вкладке без ошибки.
+## v1.7.2 — 2026-07-04 (fix for the mobile "configuration error")
+- THE CAUSE: the card was hooked up only via `add_extra_js_url` (extra_module_url), whose loading the
+ frontend does NOT wait for — on a cold start of the mobile app the dashboard was drawn
+ before the element was registered → "configuration error". (All working HACS cards are Lovelace resources.)
+- FIX 1: the integration registers the card as a **Lovelace resource** (module) — the frontend waits for
+ those before rendering. Idempotent (updates the URL on a version change, no duplicates); a fallback to
+ extra_module_url for Lovelace YAML mode. `_register_lovelace_resource` in __init__.py.
+- FIX 2: `_loadFromServer` retries (up to 8 attempts on hass updates) — if hass arrived before
+ WS readiness, the card does not get stuck on the onboarding but waits for the config.
+- Verified: the houseplan-card.js resource is registered, extra_module_url is empty (a single clean
+ module), the card renders the plan on a fresh tab without the error.
-## v1.7.0 — 2026-07-04 (аудит + рефакторинг + тесты)
-- Удалён вшитый в бандл дом-образец (дача, ~245 КБ base64 планов + ROOMS/FLOOR_*): бандл
- 293 КБ → 83 КБ. Свежая установка показывает онбординг «Добавить пространство», а не чужой дом.
-- Удалён код миграции legacy→сервер (дача уже на server config) и мёртвые пути
- device_overrides/virtual_devices (заменены markers[]).
-- Чистая логика вынесена в src/logic.ts (lqiColor, snapToGrid, segKey, pointInPolygon,
- markerIdForBinding, averageLqi) — покрыта юнит-тестами (node:test, 9 тестов + iconFor).
-- Бэкенд: валидация/санитайзеры вынесены в validation.py (без HA-импортов) — pytest, 10 тестов.
-- БЕЗОПАСНОСТЬ: тест выявил, что санитайзер имён файлов/маркеров сохранял ведущие точки
- (риск обхода каталогов через «..»); добавлено срезание ведущих точек, пустое → misc/file.
-- Исправлены реальные баги, ранее замаскированные обрезанным rules.ts: DOMAIN_PRIORITY был
- усечён (ломало выбор more-info-сущности); _defaultPositions падал на полигон-комнатах
- (теперь bbox). tsc --noEmit добавлен в сборку и CI — строгая типизация проходит.
-- Убраны дубли-мусор src/data/{editor,rules}.ts; версии синхронизированы (manifest застрял на 1.4.0).
-- CI: добавлены typecheck, юнит-тесты фронта и бэка.
+## v1.7.0 — 2026-07-04 (audit + refactoring + tests)
+- Removed the sample house baked into the bundle (the dacha, ~245 KB of base64 plans + ROOMS/FLOOR_*): the bundle
+ went 293 KB → 83 KB. A fresh install shows the "Add a space" onboarding, not someone else's house.
+- Removed the legacy→server migration code (the dacha is already on the server config) and the dead
+ device_overrides/virtual_devices paths (replaced by markers[]).
+- Pure logic extracted into src/logic.ts (lqiColor, snapToGrid, segKey, pointInPolygon,
+ markerIdForBinding, averageLqi) — covered by unit tests (node:test, 9 tests + iconFor).
+- Backend: validation/sanitizers extracted into validation.py (no HA imports) — pytest, 10 tests.
+- SECURITY: a test revealed that the file/marker name sanitizer preserved leading dots
+ (a directory traversal risk via ".."); leading-dot stripping added, empty → misc/file.
+- Fixed real bugs previously masked by the truncated rules.ts: DOMAIN_PRIORITY was
+ cut short (breaking the more-info entity selection); _defaultPositions crashed on polygon rooms
+ (now bbox). tsc --noEmit added to the build and CI — strict typing passes.
+- Removed the junk duplicates src/data/{editor,rules}.ts; versions synchronized (the manifest was stuck at 1.4.0).
+- CI: added typecheck, frontend and backend unit tests.
## v1.6.2 — 2026-07-04
-- Поле «Комната» в диалоге устройства теперь для ВСЕХ значков (не только виртуальных):
- для привязанных — «переопределить размещение» (по умолчанию по зоне устройства); смена
- комнаты переставляет значок в её центр. Сохраняется в marker.space/area и выигрывает у зоны HA.
-- В инфо-карточке добавлена кнопка «Редактировать» — открывает диалог редактирования устройства.
+- The "Room" field in the device dialog is now for ALL icons (not only virtual ones):
+ for bound ones it "overrides the placement" (by default, the device's area); changing the
+ room moves the icon to its center. Stored in marker.space/area and wins over the HA area.
+- An "Edit" button was added to the info card — it opens the device edit dialog.
-## v1.6.0 — 2026-07-04 (Фаза 3: редактор устройств)
-- Модель «маркеров» (config.markers[]): гибрид — авто-устройства HA появляются сами, маркеры
- правят/перепривязывают/дополняют их и описывают ручные/виртуальные значки. id маркера
- сохраняет позицию (device→device_id, entity→lg_, virtual→v_).
-- Клик по значку: обычный режим → инфо-карточка (имя, модель, состояние, ссылка, описание,
- PDF-инструкции, кнопка «Открыть в HA»); режим правки → диалог редактирования.
-- Диалог устройства: имя, привязка (пикер всех устройств/групп HA+Z2M+хелперов с текстовым
- фильтром, минус уже размещённые и дубли по имя|area, + «Виртуальное устройство»), MDI-иконка
- (ha-icon-picker), модель, ссылка, описание, прикрепление файлов-инструкций (PDF на сервер),
- комната (для виртуальных), Убрать/Отмена/Сохранить.
-- Тулбар: кнопка «+» (тултип «Добавить устройство») — пустой диалог.
-- Бэкенд: MARKER_SCHEMA в config; WS houseplan/file/set (файлы в /config/houseplan/files/,
- ≤25 МБ, отдача /houseplan_files/files/); статика files зарегистрирована.
-- Виртуальные значки теперь перетаскиваются и позиционируются как обычные (layout по id).
+## v1.6.0 — 2026-07-04 (Phase 3: device editor)
+- The "markers" model (config.markers[]): a hybrid — auto-discovered HA devices appear by themselves, markers
+ edit/rebind/augment them and describe manual/virtual icons. The marker id
+ preserves the position (device→device_id, entity→lg_, virtual→v_).
+- Clicking an icon: normal mode → the info card (name, model, state, link, description,
+ PDF manuals, an "Open in HA" button); edit mode → the edit dialog.
+- The device dialog: name, binding (a picker of all HA+Z2M devices/groups+helpers with a text
+ filter, minus already-placed ones and duplicates by name|area, plus "Virtual device"), MDI icon
+ (ha-icon-picker), model, link, description, manual file attachment (PDF to the server),
+ room (for virtual ones), Remove/Cancel/Save.
+- Toolbar: a "+" button (tooltip "Add device") — an empty dialog.
+- Backend: MARKER_SCHEMA in the config; WS houseplan/file/set (files in /config/houseplan/files/,
+ ≤25 MB, served from /houseplan_files/files/); the files static path registered.
+- Virtual icons are now draggable and positioned like normal ones (layout by id).
## v1.6.1 — 2026-07-04
-- Пикер привязки прячет дубли устройств по «имя|area» (Tuya/LocalTuya), как дедуп на плане.
+- The binding picker hides device duplicates by "name|area" (Tuya/LocalTuya), same as the dedup on the plan.
-## v1.5.1 — 2026-07-04 (управление пространствами)
-- Иконка-карандаш справа от названия каждого пространства в верхнем тулбаре + кнопка «+»
- (только при server config).
-- Диалог пространства: поле «Название», превью текущей подложки + «Загрузить/Заменить…»
- (SVG/PNG/JPG/WebP, base64 → houseplan/plan/set, пропорции определяются из файла),
- кнопки Удалить / Отмена / Сохранить. Создание пустого пространства и удаление (со всеми
- комнатами и разметкой, с подтверждением). Сохранение через config/set с ревизией.
+## v1.5.1 — 2026-07-04 (space management)
+- A pencil icon to the right of each space name in the top toolbar + a "+" button
+ (only with a server config).
+- The space dialog: a "Name" field, a preview of the current background + "Upload/Replace…"
+ (SVG/PNG/JPG/WebP, base64 → houseplan/plan/set, the aspect ratio is detected from the file),
+ Delete / Cancel / Save buttons. Creating an empty space and deletion (together with all its
+ rooms and markup, with a confirmation). Saved via config/set with a revision.
-## v1.5.0 — 2026-07-04 (группы света = сущности)
-- Лампы заменены сущностями групп: HA light-groups (platform=group, area из реестра сущности)
- и Z2M-группы (device model=Group) рендерятся иконкой mdi:lightbulb-group; клик → more-info
- группы (управление всей группой и участниками штатно в HA).
-- Одиночные лампы скрываются в комнатах, где есть группа света (settings.group_lights=false
- возвращает поштучный режим).
-- Выпилена старая визуальная группировка и кастомное меню участников (упрощение кода).
-- Позиции старых групп (grp_) перенесены на новые id (lg_) в раскладке дачи.
+## v1.5.0 — 2026-07-04 (light groups = entities)
+- Lamps replaced by group entities: HA light groups (platform=group, area from the entity registry)
+ and Z2M groups (device model=Group) are rendered with the mdi:lightbulb-group icon; a click → the group's
+ more-info (controlling the whole group and its members natively in HA).
+- Individual lamps are hidden in rooms that have a light group (settings.group_lights=false
+ brings back the per-lamp mode).
+- The old visual grouping and the custom member menu were removed (code simplification).
+- The positions of the old groups (grp_) were migrated to the new ids (lg_) in the dacha layout.
-## v1.4.4 — 2026-07-04 (КРИТИЧЕСКИЙ фикс: гонка конфигураций)
-- ИНЦИДЕНТ: config сохранялся целиком по принципу last-writer-wins — открытый клиент со
- старой копией затирал чужие правки (потеряна первая итерация пользовательской разметки).
-- Фикс: оптимистичная блокировка — конфиг несёт `rev`; `config/set` принимает `expected_rev`
- и возвращает ошибку `conflict` при несовпадении; клиент перечитывает конфиг.
-- Live-синхронизация: `config/set` рассылает событие `houseplan_config_updated`; все открытые
- карточки подписаны и перечитывают конфиг автоматически (окна больше не расходятся).
-- Позиции при drag сохраняются точечно через `layout/update` (dirty-set), а не полным
- `layout/set` — раскладка тоже больше не затирается между окнами.
-- Бэкап конфига перед деплоем: .storage/houseplan.config.bak-*.
+## v1.4.4 — 2026-07-04 (CRITICAL fix: configuration race)
+- INCIDENT: the config was saved wholesale on a last-writer-wins basis — an open client with a
+ stale copy wiped other clients' edits (the first iteration of the user's markup was lost).
+- Fix: optimistic locking — the config carries a `rev`; `config/set` accepts `expected_rev`
+ and returns a `conflict` error on mismatch; the client re-reads the config.
+- Live synchronization: `config/set` broadcasts a `houseplan_config_updated` event; all open
+ cards are subscribed and re-read the config automatically (windows no longer diverge).
+- Positions during drag are saved pointwise via `layout/update` (dirty set), not a full
+ `layout/set` — the layout is also no longer wiped between windows.
+- A config backup before deployment: .storage/houseplan.config.bak-*.
## v1.4.3 — 2026-07-04
-- Иконки устройств привязываются к той же сетке, что и разметка (центр иконки = узел, снап
- при перетаскивании и вводе X/Y). Существующие 57 позиций в БД дачи снапнуты к узлам.
+- Device icons snap to the same grid as the markup (the icon center = a node, snapping
+ on drag and on X/Y input). The existing 57 positions in the dacha DB were snapped to the nodes.
-## v1.4.2 — 2026-07-04 (сетка разметки)
-- Шаг сетки уменьшен в 2 раза: GRID_N 60 → 120 (шаг 8.33 рендер-ед. ≈ 0.83% ширины плана).
-- Точки сетки рендерятся ПОВЕРХ плана и комнат (grid-rect перенесён из под-плана в верхний
- markup-слой); точки контрастнее (r=0.14g, обводка).
-- Данные дачи: границы всех 13 комнат привязаны к узлам сетки (снап рёбер, сдвиги ≤ полшага;
- правка только конфига инстанса через houseplan/config/set, код не менялся).
-- Кэш карточки: URL модуля ?v= берётся из const.VERSION — при обновлении фронтенда бампать
- const.py и рестартовать HA, иначе браузеры держат старый модуль в memory-cache.
+## v1.4.2 — 2026-07-04 (markup grid)
+- The grid step was halved: GRID_N 60 → 120 (step 8.33 render units ≈ 0.83% of the plan width).
+- Grid points are rendered ON TOP of the plan and rooms (the grid-rect was moved from below the plan
+ into the top markup layer); the points are higher-contrast (r=0.14g, outline).
+- Dacha data: the boundaries of all 13 rooms were snapped to grid nodes (edge snapping, shifts ≤ half a step;
+ only the instance config was edited via houseplan/config/set, the code was untouched).
+- Card cache: the module URL ?v= is taken from const.VERSION — when updating the frontend, bump
+ const.py and restart HA, otherwise browsers keep the old module in memory cache.
-## v1.4.1 — 2026-07-04 (UX разметки)
-- Esc / Ctrl+Z при рисовании убирают последнюю точку (и её линию, если она была добавлена
- этим шагом; переиспользованные чужие стены не трогаются).
-- Панель редактирования (разметка и правка раскладки) перенесена наверх под шапку карточки
- и закреплена вместе с ней (общий sticky-контейнер .hdr).
-- Замыкание контура автоматически открывает модальный диалог «Новая комната»: отображаемое
- имя, выпадающий список ТОЛЬКО свободных зон HA (не назначенных ни одной комнате конфига),
- Сохранить/Отмена. Отмена (или Esc) снимает замыкающую точку — контур можно продолжить.
- Выбор зоны при пустом имени подставляет название зоны.
+## v1.4.1 — 2026-07-04 (markup UX)
+- Esc / Ctrl+Z while drawing remove the last point (and its line, if it was added
+ by that step; reused walls belonging to others are untouched).
+- The editing panel (markup and layout editing) was moved to the top under the card header
+ and pinned together with it (a shared sticky container .hdr).
+- Closing the outline automatically opens the "New room" modal dialog: the display
+ name, a dropdown of ONLY the free HA areas (not assigned to any room of the config),
+ Save/Cancel. Cancel (or Esc) removes the closing point — the outline can be continued.
+ Choosing an area with an empty name fills in the area's name.
-## v1.4.0 — 2026-07-04 (Фаза 2: редактор разметки комнат)
-- Режим «Разметка» в карточке (кнопка mdi:vector-square-edit, только при server config):
- сетка точек (60 узлов по ширине), линии парами кликов со снапом к узлам, полилиния-превью.
-- Замкнутый контур (клик по первой точке) активирует «Сохранить»: выбор зоны HA из
- выпадающего списка + название; комната сохраняется полигоном (poly, нормированные вершины).
-- Инструменты: Добавить (рисование), Стереть линию (клик по линии), Удалить комнату
- (клик внутри + confirm). Линии-«стены» хранятся в space.segments и переиспользуются
- соседними комнатами (общие стены — кликами по существующим узлам).
-- Рендер комнат: полигоны наравне с прямоугольниками (hover, клик в зону, LQI-тултип,
- подпись в центроиде); в режиме разметки контуры и названия всех комнат видимы.
-- Бэкенд: ROOM_SCHEMA принимает poly (≥3 вершин) или x/y/w/h; SPACE_SCHEMA — segments.
+## v1.4.0 — 2026-07-04 (Phase 2: room markup editor)
+- The "Markup" mode in the card (the mdi:vector-square-edit button, only with a server config):
+ a grid of points (60 nodes across the width), lines drawn by pairs of clicks with node snapping, a polyline preview.
+- A closed outline (a click on the first point) activates "Save": choosing an HA area from a
+ dropdown + a name; the room is saved as a polygon (poly, normalized vertices).
+- Tools: Add (drawing), Erase line (a click on a line), Delete room
+ (a click inside + confirm). The "wall" lines are stored in space.segments and reused by
+ neighboring rooms (shared walls — via clicks on existing nodes).
+- Room rendering: polygons on par with rectangles (hover, click into the area, LQI tooltip,
+ the label at the centroid); in markup mode the outlines and names of all rooms are visible.
+- Backend: ROOM_SCHEMA accepts poly (≥3 vertices) or x/y/w/h; SPACE_SCHEMA — segments.
-## v1.3.0 — 2026-07-04 (Фаза 1: серверная конфигурация)
-- Store `houseplan.config`: spaces (план, aspect, view_box, комнаты), device_overrides
+## v1.3.0 — 2026-07-04 (Phase 1: server-side configuration)
+- The `houseplan.config` Store: spaces (plan, aspect, view_box, rooms), device_overrides
(hidden/icon/name), virtual_devices, settings (exclude_integrations, group_lights).
-- WS: `houseplan/config/get|set`, `houseplan/plan/set` (загрузка файла плана base64 →
- `/houseplan/plans/`, отдача через /houseplan_files/plans/).
-- Карточка: резолв-модель — server config (координаты НОРМИРОВАННЫЕ 0..1, рендер 1000×1000/aspect)
- или legacy-бандл (холст 1489×1053). Раскладка v2: {device_id: {s, x, y}} нормированная.
-- Кнопка «На сервер» в режиме правки — миграция legacy-конфига в один клик (планы, комнаты,
- view_box, раскладка). Выполнена на даче: .storage/houseplan.config + plans/f1.svg,f2.svg.
-- Read-side поддержка оверрайдов устройств и виртуальных устройств (UI управления — фазы 3–4).
+- WS: `houseplan/config/get|set`, `houseplan/plan/set` (plan file upload as base64 →
+ `/houseplan/plans/`, served through /houseplan_files/plans/).
+- The card: a resolve model — the server config (coordinates NORMALIZED 0..1, render 1000×1000/aspect)
+ or the legacy bundle (canvas 1489×1053). Layout v2: {device_id: {s, x, y}} normalized.
+- The "To server" button in edit mode — a one-click migration of the legacy config (plans, rooms,
+ view_box, layout). Performed at the dacha: .storage/houseplan.config + plans/f1.svg,f2.svg.
+- Read-side support for device overrides and virtual devices (the management UI — phases 3–4).
## v1.2.2 — 2026-07-04
-- Тулбар карточки (вкладки этажей) закрепляется при скролле под шапкой HA
+- The card toolbar (floor tabs) pins under the HA header while scrolling
(`position: sticky; top: var(--header-height)`; ha-card overflow: visible).
-- Инцидент: промежуточная сборка на нестабильном mount дала битый бандл, роняющий рендер
- дашбордов; правило «собирать только в /tmp + md5-контроль» закреплено в DEVELOPMENT.md.
+- Incident: an intermediate build on the unstable mount produced a broken bundle that crashed the
+ dashboard rendering; the rule "build only in /tmp + md5 control" was locked into DEVELOPMENT.md.
## v1.2.1 — 2026-07-04
-- Иконки не увеличиваются при наведении/перетаскивании (убран transform: scale).
+- Icons no longer enlarge on hover/drag (transform: scale removed).
## v1.2.0 — 2026-07-03
-- Границы комнат сняппены к стенам векторного плана.
-- Zigbee LQI: значение под иконкой, среднее по комнате в тултипе, градиент красный→зелёный,
- опция show_signal.
-- `mdi:lock` для любых устройств с сущностью lock.* (TTLock).
-- Выключатель прихожей: исправлена зона устройства в реестре HA (был в detskaia_elina).
+- Room boundaries snapped to the walls of the vector plan.
+- Zigbee LQI: the value under the icon, the room average in the tooltip, a red→green gradient,
+ the show_signal option.
+- `mdi:lock` for any devices with a lock.* entity (TTLock).
+- The hallway switch: the device's area in the HA registry was fixed (it was in detskaia_elina).
## v1.1.0 — 2026-07-03
-- Векторные подложки (SVG РЕМПЛАННЕР), автосовмещение масштаба/сдвига растровой корреляцией.
-- Размер иконок в % ширины плана (container queries, дефолт 2.5%).
+- Vector backgrounds (SVG from REMPLANNER), automatic scale/offset alignment via raster correlation.
+- Icon size as a % of the plan width (container queries, default 2.5%).
## v1.0.1 — 2026-07-03
-- fix: вложенные SVG-фрагменты через lit svg`` (подложка/комнаты не рендерились).
-- fix: версия из const вместо блокирующего чтения manifest.json в event loop.
+- fix: nested SVG fragments via lit svg`` (the background/rooms were not rendered).
+- fix: the version taken from const instead of a blocking manifest.json read in the event loop.
## v1.0.0 — 2026-07-03
-- Первый релиз: Lovelace-карточка (TS+Lit, без токена, от hass) + интеграция houseplan
- (WS-хранилище раскладки, раздача JS). Перенос модели прототипа: курирование, группы ламп,
- iconFor, температура, more-info, навигация в зоны, drag-раскладка.
+- First release: the Lovelace card (TS+Lit, no token, driven by hass) + the houseplan integration
+ (WS layout storage, JS serving). The prototype's model carried over: curation, lamp groups,
+ iconFor, temperature, more-info, area navigation, drag layout.
diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md
index 77290db..dc920ca 100644
--- a/docs/DEVELOPMENT.md
+++ b/docs/DEVELOPMENT.md
@@ -1,77 +1,77 @@
-# Разработка и деплой
+# Development and deployment
-## Окружение (cowork-сессии)
+## Environment (cowork sessions)
-- Эталон кода — **git-репозиторий** (в сессии живёт в `/tmp/hpc`, восстанавливается из
- `houseplan-card.git.bundle`: `git clone houseplan-card.git.bundle hpc`).
-- Папка пользователя `houseplan/houseplan-card/` — зеркало репо (rsync после каждого коммита)
- + актуальный `houseplan-card.git.bundle`.
+- The source of truth for the code is the **git repository** (lives in `/tmp/hpc` during a session,
+ restored from `houseplan-card.git.bundle`: `git clone houseplan-card.git.bundle hpc`).
+- The user's folder `houseplan/houseplan-card/` is a mirror of the repo (rsync after every commit)
+ + an up-to-date `houseplan-card.git.bundle`.
-### ⚠️ Грабли файловой синхронизации (критично)
-1. Сетевой mount иногда отдаёт файлы **обрезанными/перемешанными** — правки через Edit-tool
- с Windows-стороны ненадёжны. Правило: **править python-патчами по чистой копии в /tmp,
- писать через bash**, assert на count(old)==1.
-2. **Сборку rollup вести ТОЛЬКО в /tmp/hpc** (`npm ci` уже сделан). Сборка на mount однажды
- дала синтаксически валидный, но битый бандл («wi is not defined»), который валил рендер
- ВСЕХ дашбордов HA (карточка грузится как extra_module на каждой странице!).
-3. `.git` на mount не создаётся («Operation not permitted» на dot-каталогах) — поэтому bundle.
+### ⚠️ File-sync pitfalls (critical)
+1. The network mount sometimes serves files **truncated/scrambled** — edits via the Edit tool
+ from the Windows side are unreliable. Rule: **apply python patches against a clean copy in /tmp,
+ write via bash**, with an assert that count(old)==1.
+2. **Run the rollup build ONLY in /tmp/hpc** (`npm ci` is already done). A build on the mount once
+ produced a syntactically valid but broken bundle ("wi is not defined") that crashed the rendering
+ of ALL HA dashboards (the card is loaded as an extra_module on every page!).
+3. `.git` cannot be created on the mount ("Operation not permitted" on dot-directories) — hence the bundle.
-## Тесты
+## Tests
-- Фронт: `npm test` — компилит src/logic.ts+rules.ts (tsconfig.test.json) и гоняет node:test
- (test/*.test.mjs). Строгая типизация: `npm run typecheck` (tsc --noEmit, входит в `npm run build`).
-- Бэк: `python -m pytest tests_backend/` — чистая валидация custom_components/houseplan/validation.py
- (грузится по пути, без импорта HA-пакета).
-- ВАЖНО (аудит-урок): rollup-плагин typescript выдаёт синтаксическую ошибку как WARNING и всё равно
- собирает бандл — обрезанный файл может «пройти». Поэтому в сборке первым идёт `tsc --noEmit`,
- который падает на таких ошибках. Всегда собирать `npm run build`, не голый `rollup -c`.
+- Frontend: `npm test` — compiles src/logic.ts+rules.ts (tsconfig.test.json) and runs node:test
+ (test/*.test.mjs). Strict typing: `npm run typecheck` (tsc --noEmit, part of `npm run build`).
+- Backend: `python -m pytest tests_backend/` — pure validation of custom_components/houseplan/validation.py
+ (loaded by path, without importing the HA package).
+- IMPORTANT (audit lesson): the rollup typescript plugin reports a syntax error as a WARNING and still
+ builds the bundle — a truncated file can "pass". That is why the build starts with `tsc --noEmit`,
+ which fails on such errors. Always build with `npm run build`, never bare `rollup -c`.
-## Сборка
+## Build
```bash
-cd /tmp/hpc && npm ci # один раз
+cd /tmp/hpc && npm ci # once
npx rollup -c # → dist/houseplan-card.js
node --check dist/houseplan-card.js
cp dist/houseplan-card.js custom_components/houseplan/frontend/
```
-## Деплой на дачу (ha.jbstudio.pro)
+## Deployment to the dacha (ha.jbstudio.pro)
-- SSH: порт **323**, root, ключ `ha_jb` (пользователь загружает в чат; в песочнице /tmp/ha_jb, chmod 600).
+- SSH: port **323**, root, key `ha_jb` (the user uploads it to the chat; in the sandbox /tmp/ha_jb, chmod 600).
- JS: `scp -P 323 -i /tmp/ha_jb dist/houseplan-card.js root@ha.jbstudio.pro:/config/custom_components/houseplan/frontend/`
-- Интеграция целиком: tar c custom_components/houseplan (--exclude __pycache__) → tar x на сервере.
-- **Проверка обязательна**: `md5sum` локально == на сервере == `curl http://homeassistant:8123/houseplan_files/houseplan-card.js | md5sum`
- (внутри SSH-аддона `localhost` — НЕ HA, использовать хост `homeassistant`).
-- Изменения Python требуют рестарта HA (`ha core restart`, держит соединение до конца, HTTP
- поднимается через 1–3 мин). Изменения JS — только обновление страницы (static path отдаётся
- с no-cache).
-- После деплоя JS — проверить в браузере (Ctrl+F5) и console (не должно быть ошибок из
- houseplan-card.js; битый бандл роняет все дашборды).
+- The whole integration: tar c custom_components/houseplan (--exclude __pycache__) → tar x on the server.
+- **Verification is mandatory**: `md5sum` locally == on the server == `curl http://homeassistant:8123/houseplan_files/houseplan-card.js | md5sum`
+ (inside the SSH add-on `localhost` is NOT HA, use the host `homeassistant`).
+- Python changes require an HA restart (`ha core restart`, holds the connection until it finishes, HTTP
+ comes back up in 1–3 min). JS changes — just a page refresh (the static path is served
+ with no-cache).
+- After deploying JS — check in the browser (Ctrl+F5) and the console (there must be no errors from
+ houseplan-card.js; a broken bundle takes down all dashboards).
-## Кэш фронтенда и «пустой вид»
+## Frontend cache and the "empty view"
-- URL модуля карточки содержит `?v=`. Браузеры держат ES-модуль в
- memory-cache: после деплоя нового JS **бампните VERSION в const.py и рестартуйте HA**,
- иначе обычный F5 оставит старую версию.
-- После reload страницы HA-фронтенд (с kiosk-mode) иногда оставляет вид пустым
- («InvalidStateError: Transition was aborted», hui-view не создаётся 1–2 мин).
- Лечится повторной SPA-навигацией: pushState + событие location-changed, или подождать.
+- The card module URL contains `?v=`. Browsers keep the ES module in
+ memory cache: after deploying new JS **bump VERSION in const.py and restart HA**,
+ otherwise a plain F5 will keep the old version.
+- After a page reload the HA frontend (with kiosk-mode) sometimes leaves the view empty
+ ("InvalidStateError: Transition was aborted", hui-view is not created for 1–2 min).
+ Cured by repeating the SPA navigation: pushState + a location-changed event, or just waiting.
-## Релиз
+## Release
-Тег `vX.Y.Z` + GitHub Release → workflow `.github/workflows/release.yml` собирает и прикладывает
-`houseplan-card.js`. Версию бампать синхронно: `src/houseplan-card.ts` (CARD_VERSION),
+Tag `vX.Y.Z` + GitHub Release → the workflow `.github/workflows/release.yml` builds and attaches
+`houseplan-card.js`. Bump the version everywhere in sync: `src/houseplan-card.ts` (CARD_VERSION),
`package.json`, `custom_components/houseplan/manifest.json`, `custom_components/houseplan/const.py`.
-## Воспроизводимые скрипты (данные)
+## Reproducible scripts (data)
-- Извлечение геометрии/подложек из прототипа и генерация `src/data/*` — см. историю коммитов
- и docs/ARCHITECTURE.md (трансформации SVG→базовое пространство: f1 0.647/(490,27), f2 0.896/(351,21)).
-- Подгонка комнат: рендер плана с прямоугольниками поверх (cv2) → снап к стенам → ручная доводка.
+- Extracting the geometry/backgrounds from the prototype and generating `src/data/*` — see the commit
+ history and docs/ARCHITECTURE.md (SVG→base-space transforms: f1 0.647/(490,27), f2 0.896/(351,21)).
+- Room fitting: render the plan with rectangles overlaid (cv2) → snap to walls → manual fine-tuning.
-## Прод-объекты в HA (дача)
+## Production objects in HA (the dacha)
-- Дашборд `plan-doma`, панельный вид, карточка `custom:houseplan-card` (icon_size 2.5).
-- Интеграция houseplan: entry загружен, `.storage/houseplan.layout` — раскладка (сервер).
-- Старый прототип `/config/www/houseplan/` (iframe) сохранён как запасной, не трогать.
-- Бэкапы configuration.yaml: `.bak-avgtemp` (до правки среднего датчика).
+- Dashboard `plan-doma`, panel view, card `custom:houseplan-card` (icon_size 2.5).
+- The houseplan integration: entry loaded, `.storage/houseplan.layout` — the layout (server-side).
+- The old prototype `/config/www/houseplan/` (iframe) is kept as a fallback, do not touch.
+- configuration.yaml backups: `.bak-avgtemp` (before the average-temperature sensor edit).
diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md
index 7c76ae8..bee8bb3 100644
--- a/docs/ROADMAP.md
+++ b/docs/ROADMAP.md
@@ -1,73 +1,73 @@
-# Роадмап: от «карты дачи» к публикуемой универсальной интеграции
+# Roadmap: from a "dacha map" to a publishable universal integration
-Цель: опубликовать в HACS (сначала custom repository, затем PR в default) универсальную
-интеграцию «интерактивный план дома»: свои планы на пространство, ручная разметка комнат,
-полуавтоматическое размещение устройств, скрытие/переименование/смена иконок, виртуальные
-устройства. Никакого хардкода конкретного дома в коде.
+Goal: publish to HACS (first as a custom repository, then a PR into default) a universal
+"interactive house plan" integration: custom plans per space, manual room markup,
+semi-automatic device placement, hiding/renaming/changing icons, virtual
+devices. No hardcoding of a specific house in the code.
-## Принципы (зафиксировано)
-- Пишем полноценный компонент по паттернам HA dev docs, не захардкоженную фичу.
-- Все данные конкретного дома — это **конфигурация инстанса** (server-side Store),
- а не код/бандл. Текущие данные дачи станут первым мигрированным инстансом.
-- Документировать всё сразу в docs/ (контекст сессий теряется).
-- Версионирование хранилищ (Store minor_version + async_migrate) с первого дня.
+## Principles (locked in)
+- We write a proper full component following HA dev docs patterns, not a hardcoded feature.
+- All data of a specific house is **instance configuration** (server-side Store),
+ not code/bundle. The current dacha data will become the first migrated instance.
+- Document everything immediately in docs/ (session context gets lost).
+- Storage versioning (Store minor_version + async_migrate) from day one.
-## Фаза 0 — Гигиена публикации (быстро, без новых фич)
-- [x] hacs.json, manifest с обязательными ключами, структура custom_components/*
-- [x] CI: hacs/action + hassfest (workflow validate.yml) — добавлено, проверить на GitHub
+## Phase 0 — Publication hygiene (quick, no new features)
+- [x] hacs.json, manifest with the required keys, custom_components/* structure
+- [x] CI: hacs/action + hassfest (workflow validate.yml) — added, verify on GitHub
- [x] brand/icon.png
-- [ ] Публичный GitHub-репозиторий: description, topics, issues on; первый Release v1.2.x
-- [ ] README EN (основной) + README.ru.md; скриншоты/GIF (обязательны для витрины HACS)
-- [ ] Заменить codeowners/documentation/issue_tracker на реальные URL после создания репо
+- [ ] Public GitHub repository: description, topics, issues on; first Release v1.2.x
+- [ ] README EN (primary) + README.ru.md; screenshots/GIF (mandatory for the HACS storefront)
+- [ ] Replace codeowners/documentation/issue_tracker with real URLs after the repo is created
-## Фаза 1 — Конфиг на сервере (декаплинг от дачи) ← ✅ СДЕЛАНО в v1.3.0 (кроме выпиливания бандл-данных — оставлены как fallback до фазы 2)
-Новое хранилище `houseplan.config` (Store v1):
+## Phase 1 — Server-side config (decoupling from the dacha) ← ✅ DONE in v1.3.0 (except removing the bundle data — kept as a fallback until phase 2)
+New store `houseplan.config` (Store v1):
```json
-{ "spaces": [ { "id": "f1", "title": "1 этаж", "plan": {"media_id": "...", "type": "svg"},
+{ "spaces": [ { "id": "f1", "title": "1st floor", "plan": {"media_id": "...", "type": "svg"},
"view_box": [x,y,w,h], "rooms": [{"id","name","area_id","x","y","w","h"}] } ],
"device_overrides": { "": {"hidden":bool,"icon":str,"name":str} },
"virtual_devices": [ {"id","space","name","icon","x","y","note"?, "entity_id"?} ],
"settings": {"exclude_integrations": [...], "group_lights": bool, ...} }
```
-- WS API v2: `houseplan/config/get|set`, `houseplan/plan/upload` (файл плана →
- `/houseplan/` через process-executor, отдача через static path), layout как сейчас.
-- Карточка: при наличии server-config использует его; бандл-данные дачи становятся
- **fallback-примером** и затем выпиливаются (миграционный скрипт зальёт их в Store).
-- Единицы координат: нормированные (0..1 от плана) для новых конфигов — независимость от
- разрешения исходника; миграция дачи пересчитает 1489×1053 → нормированные.
+- WS API v2: `houseplan/config/get|set`, `houseplan/plan/upload` (plan file →
+ `/houseplan/` via the process executor, served through a static path), layout as today.
+- The card: when a server config exists it uses it; the dacha bundle data becomes a
+ **fallback example** and is then removed (a migration script will push it into the Store).
+- Coordinate units: normalized (0..1 of the plan) for new configs — independence from the
+ source resolution; the dacha migration will convert 1489×1053 → normalized.
-## Фаза 2 — Редактор разметки в карточке ← ✅ ЯДРО СДЕЛАНО в v1.4.0 (осталось: загрузка плана из UI, правка view_box, редактирование существующих комнат)
-- Режим «Настройка» (отдельно от drag-раскладки): рисование/ресайз прямоугольников комнат
- поверх плана, привязка к area (селектор ha-area-picker), редактирование viewBox (кадр).
-- Позже: полигональные комнаты (SVG path), повороты планов.
-- Загрузка плана из UI (file upload → WS) + выбор существующего media.
+## Phase 2 — Markup editor in the card ← ✅ CORE DONE in v1.4.0 (remaining: plan upload from the UI, view_box editing, editing existing rooms)
+- A "Setup" mode (separate from drag layout): drawing/resizing room rectangles
+ on top of the plan, binding to an area (ha-area-picker selector), viewBox (frame) editing.
+- Later: polygonal rooms (SVG path), plan rotations.
+- Plan upload from the UI (file upload → WS) + picking existing media.
-## Фаза 3 — Управление устройствами ← ✅ СДЕЛАНО в v1.6.x (скрытие, иконка, имя, модель, ссылка, описание, PDF, перепривязка, «+», виртуальные)
-- Панель устройств в режиме настройки: список неразмещённых (с фильтрами), drag из панели
- на план; авто-раскладка «сеткой по комнате» кнопкой.
-- Оверрайды per-device: скрыть, своя иконка (ha-icon-picker), своё имя. Хранение в config.
-- Настраиваемое курирование: исключения интеграций/доменов в options flow вместо хардкода.
+## Phase 3 — Device management ← ✅ DONE in v1.6.x (hiding, icon, name, model, link, description, PDF, rebinding, "+", virtual)
+- A device panel in setup mode: a list of unplaced devices (with filters), drag from the panel
+ onto the plan; auto-layout "grid over the room" by button.
+- Per-device overrides: hide, custom icon (ha-icon-picker), custom name. Stored in config.
+- Configurable curation: integration/domain exclusions in the options flow instead of hardcode.
-## Фаза 4 — Виртуальные устройства ← ✅ базово в v1.6.x (CRUD виртуальных маркеров в общем диалоге; отдельная доработка заметок/иконок по мере надобности)
-- CRUD виртуальных маркеров (имя, иконка, координаты, заметка; опционально ссылка на
- entity/URL): септик, кран, счётчик без датчика и т.п. Рендер как обычные иконки,
- клик → карточка с заметкой или more-info привязанной сущности.
+## Phase 4 — Virtual devices ← ✅ basics in v1.6.x (CRUD of virtual markers in the shared dialog; further note/icon polish as needed)
+- CRUD of virtual markers (name, icon, coordinates, note; optionally a link to an
+ entity/URL): septic tank, valve, a meter without a sensor, etc. Rendered like normal icons,
+ click → a card with the note or more-info of the bound entity.
-## Фаза 5 — Полировка UX/фич
-- Клик-действия по настройке: toggle для света/розеток, long-press → more-info.
-- Тюнинг live-индикации (цвета по теме, badge-и), light-тема.
-- Тултипы на тач-устройствах (long-press), доступность (клавиатура, aria).
-- Опция LQI: порог «плохого» сигнала, скрытие меток на не-zigbee инстансах.
+## Phase 5 — UX/feature polish
+- Configurable click actions: toggle for lights/outlets, long-press → more-info.
+- Live-indication tuning (theme-aware colors, badges), light theme.
+- Tooltips on touch devices (long-press), accessibility (keyboard, aria).
+- LQI option: "bad signal" threshold, hiding the labels on non-zigbee instances.
-## Фаза 6 — Качество и публикация
-- Тесты: pytest (config_flow, websocket_api, миграции Store) + hassfest/hacs action в CI;
- фронт: vitest на rules/geometry-утилиты.
-- Типизация: strict TS-интерфейсы hass (custom-card-helpers или свои), mypy для python.
-- Переводы integration+card: en + ru (translations/, локализация строк карточки).
-- Quality scale bronze → silver чек-лист; PR в hacs/default; опционально PR в
- home-assistant/brands (пока хватает brand/ в репо).
+## Phase 6 — Quality and publication
+- Tests: pytest (config_flow, websocket_api, Store migrations) + hassfest/hacs action in CI;
+ frontend: vitest for rules/geometry utilities.
+- Typing: strict TS interfaces for hass (custom-card-helpers or our own), mypy for python.
+- Translations for integration+card: en + ru (translations/, card string localization).
+- Quality scale bronze → silver checklist; PR into hacs/default; optionally a PR into
+ home-assistant/brands (the brand/ in the repo suffices for now).
-## Открытые вопросы
-- Имя для публикации: «House Plan Card»? домен `houseplan` не занят в HACS default — проверить.
-- Лицензия MIT (в package.json уже MIT) — добавить LICENSE файл.
-- Формат планов: SVG предпочтителен (вектор, вес), PNG поддержать обязательно.
+## Open questions
+- Publication name: "House Plan Card"? the `houseplan` domain is not taken in HACS default — verify.
+- MIT license (package.json is already MIT) — add a LICENSE file.
+- Plan formats: SVG preferred (vector, size), PNG support is mandatory.
diff --git a/package.json b/package.json
index d56b8df..21e8c70 100755
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "houseplan-card",
- "version": "1.10.0",
+ "version": "1.11.0",
"description": "Interactive house plan Lovelace card for Home Assistant",
"license": "MIT",
"type": "module",
diff --git a/scripts_publish.sh b/scripts_publish.sh
deleted file mode 100755
index f805763..0000000
--- a/scripts_publish.sh
+++ /dev/null
@@ -1,24 +0,0 @@
-#!/usr/bin/env bash
-# Публикация House Plan на GitHub + релиз. Запускать на своей машине, где ты залогинен в GitHub.
-# Требуется установленный git и gh (GitHub CLI: https://cli.github.com), выполнить `gh auth login` один раз.
-set -e
-OWNER="Matysh" # владелец репозитория (github.com/Matysh)
-REPO="houseplan-card"
-
-# 1) распаковать репозиторий из бандла (если ещё нет рабочей копии)
-# git clone houseplan-card.git.bundle "$REPO" && cd "$REPO"
-
-# 2) создать ПУБЛИЧНЫЙ репозиторий и запушить всё + теги
-gh repo create "$OWNER/$REPO" --public \
- --description "Интерактивный план дома для Home Assistant: этажи, комнаты и устройства на настоящем плане. Всё через UI, без YAML." \
- --source . --remote origin --push
-
-# 3) добавить topics (для поиска в HACS)
-gh repo edit "$OWNER/$REPO" --add-topic home-assistant --add-topic hacs \
- --add-topic lovelace --add-topic floorplan --add-topic custom-integration --add-topic zigbee
-
-# 4) опубликовать РЕЛИЗ (не просто тег) с заметками
-git push origin v1.9.3
-gh release create v1.9.3 --title "House Plan v1.9.3" --notes-file RELEASE_NOTES_v1.9.3.md
-
-echo "Готово. Теперь репозиторий устанавливается как HACS Custom repository (категория Integration)."
diff --git a/src/devices.ts b/src/devices.ts
index 1eb01f1..0e26d54 100644
--- a/src/devices.ts
+++ b/src/devices.ts
@@ -1,21 +1,23 @@
/**
- * Построение списка устройств из реестров HA: курирование, группы света,
- * маркеры (оверрайды/виртуальные). Без Lit/DOM — только hass-объект.
+ * Building the device list from HA registries: curation, light groups,
+ * markers (overrides/virtual). No Lit/DOM — only the hass object.
*/
import { iconFor, DOMAIN_PRIORITY } from './rules';
import { averageLqi } from './logic';
import type { DevItem, Marker, ServerConfig } from './types';
-/** Контекст построения: срез hass + резолв конфига. */
+/** Build context: a slice of hass + config resolution. */
export interface BuildCtx {
hass: any;
- /** area_id → space_id (только зоны, привязанные к комнатам). */
+ /** area_id → space_id (only zones bound to rooms). */
areaToSpace: Record;
markers: Marker[];
settings: ServerConfig['settings'];
excluded: Set;
showAll: boolean;
firstSpaceId: string;
+ /** Localized display strings for generated device names. */
+ loc: (key: 'device.unnamed' | 'device.light_group' | 'device.fallback' | 'device.virtual') => string;
}
export function entitiesByDevice(hass: any): Record {
@@ -61,21 +63,21 @@ export function primaryEntity(hass: any, entIds: string[], icon: string): string
return pool[0]?.eid;
}
-/** Средний LQI zigbee по сущностям устройства (сенсоры *_linkquality/*_lqi либо атрибут). */
+/** Average zigbee LQI across the device's entities (*_linkquality/*_lqi sensors or an attribute). */
export function lqiFor(hass: any, entIds: string[]): number | null {
const vals: number[] = [];
for (const eid of entIds) {
const st = hass.states[eid];
if (!st) continue;
const unit = (st.attributes?.unit_of_measurement || '').toLowerCase();
- // 1) выделенный сенсор сигнала: Z2M *_linkquality, ZHA *_lqi, либо единицы «lqi»
+ // 1) dedicated signal sensor: Z2M *_linkquality, ZHA *_lqi, or “lqi” units
if (/_(linkquality|lqi)$/.test(eid) || unit === 'lqi') {
const v = parseFloat(st.state);
if (!isNaN(v)) vals.push(v);
continue;
}
- // 2) сигнал как АТРИБУТ на любой сущности устройства (Z2M linkquality / ZHA lqi) —
- // покрывает устройства, у которых отдельный сенсор сигнала отключён
+ // 2) signal as an ATTRIBUTE on any entity of the device (Z2M linkquality / ZHA lqi) —
+ // covers devices whose dedicated signal sensor is disabled
const av = st.attributes?.linkquality ?? st.attributes?.lqi;
if (av != null) {
const v = parseFloat(av);
@@ -96,7 +98,7 @@ export function tempFor(hass: any, entIds: string[]): number | null {
return null;
}
-/** Групповые световые сущности: HA light-group (platform=group) и Z2M-группы (device model=Group). */
+/** Group light entities: HA light-group (platform=group) and Z2M groups (device model=Group). */
export function lightGroups(hass: any, enabled: boolean): { eid: string; name: string; area: string }[] {
if (!enabled) return [];
const res: { eid: string; name: string; area: string }[] = [];
@@ -129,9 +131,9 @@ function applyMarker(item: DevItem, m: Marker): void {
item.pdfs = m.pdfs || [];
}
-/** Курирование + группы света + маркеры (метаданные/перепривязка) + виртуальные. Гибрид. */
+/** Curation + light groups + markers (metadata/rebinding) + virtual ones. A hybrid. */
export function buildDevices(ctx: BuildCtx): DevItem[] {
- const { hass: h, areaToSpace, markers, settings, excluded, showAll, firstSpaceId } = ctx;
+ const { hass: h, areaToSpace, markers, settings, excluded, showAll, firstSpaceId, loc } = ctx;
const groupLights = settings.group_lights !== false;
const groups = lightGroups(h, groupLights);
const groupedAreas = new Set(groups.map((g) => g.area));
@@ -145,17 +147,17 @@ export function buildDevices(ctx: BuildCtx): DevItem[] {
const seen: Record = {};
const rest: DevItem[] = [];
- // 1) авто-устройства HA (не занятые маркером, не скрытые)
+ // 1) HA auto-discovered devices (not claimed by a marker, not hidden)
for (const dev of Object.values(h.devices)) {
const area = dev.area_id;
if (!area || !areaToSpace[area]) continue;
if (dev.entry_type === 'service') continue;
- if (claimed.has('device:' + dev.id)) continue; // маркер перекроет ниже
+ if (claimed.has('device:' + dev.id)) continue; // a marker will take over below
const marker = markerFor('device', dev.id);
if (marker && marker.hidden) continue;
const entIds = entsBy[dev.id] || [];
const dom = domainOfDevice(h, dev, entIds);
- // курирование (можно отключить переключателем «показать все»)
+ // curation (can be turned off with the “show all” toggle)
if (!showAll) {
if (excluded.has(dom)) continue;
if (dev.model === 'Group') continue;
@@ -163,12 +165,12 @@ export function buildDevices(ctx: BuildCtx): DevItem[] {
if (/bridge/i.test((dev.model || '') + (dev.name || ''))) continue;
if (dom === 'myheat' && dev.via_device_id) continue;
}
- const name = (dev.name_by_user || dev.name || 'без имени').trim();
+ const name = (dev.name_by_user || dev.name || loc('device.unnamed')).trim();
const key = name + '|' + area;
let icon = iconFor(name, dev.model);
if (entIds.some((e) => e.startsWith('lock.'))) icon = 'mdi:lock';
if (!showAll && groupLights && icon === 'mdi:lightbulb' && groupedAreas.has(area)) continue;
- // дубли по «имя|зона» не скрываем, а нумеруем
+ // duplicates by “name|zone” are numbered rather than hidden
seen[key] = (seen[key] || 0) + 1;
const dispName = seen[key] > 1 ? name + ' ' + seen[key] : name;
const item: DevItem = {
@@ -188,14 +190,14 @@ export function buildDevices(ctx: BuildCtx): DevItem[] {
rest.push(item);
}
- // 2) группы света (не занятые маркером)
+ // 2) light groups (not claimed by a marker)
for (const g of groups) {
if (!areaToSpace[g.area]) continue;
if (claimed.has('entity:' + g.eid)) continue;
rest.push({
id: 'lg_' + g.eid,
name: g.name,
- model: 'группа света',
+ model: loc('device.light_group'),
area: g.area,
space: areaToSpace[g.area],
icon: 'mdi:lightbulb-group',
@@ -207,7 +209,7 @@ export function buildDevices(ctx: BuildCtx): DevItem[] {
});
}
- // 3) явные маркеры (перепривязка/метаданные/виртуальные)
+ // 3) explicit markers (rebinding/metadata/virtual)
for (const m of markers) {
if (m.hidden) continue;
const [kind, ref] = m.binding.split(':');
@@ -220,7 +222,7 @@ export function buildDevices(ctx: BuildCtx): DevItem[] {
if (entIds.some((e) => e.startsWith('lock.'))) icon = 'mdi:lock';
const item: DevItem = {
id: m.id,
- name: dev?.name_by_user || dev?.name || 'устройство',
+ name: dev?.name_by_user || dev?.name || loc('device.fallback'),
model: dev?.model || '',
area,
space,
@@ -253,12 +255,12 @@ export function buildDevices(ctx: BuildCtx): DevItem[] {
applyMarker(item, m);
rest.push(item);
} else {
- // виртуальный
+ // virtual
const area = m.area || '';
const space = m.space || (area && areaToSpace[area]) || firstSpaceId;
const item: DevItem = {
id: m.id,
- name: m.name || 'виртуальное устройство',
+ name: m.name || loc('device.virtual'),
model: m.model || '',
area,
space,
diff --git a/src/editor.ts b/src/editor.ts
index cbc29e1..25c31cf 100755
--- a/src/editor.ts
+++ b/src/editor.ts
@@ -1,14 +1,6 @@
-/** Редактор конфигурации карточки (GUI в Lovelace). */
+/** Card configuration editor (Lovelace GUI). */
import { LitElement, html, nothing } from 'lit';
-
-const LABELS: Record = {
- title: 'Заголовок',
- default_floor: 'Пространство по умолчанию',
- icon_size: 'Размер иконок, % ширины плана',
- show_temperature: 'Показывать температуру',
- live_states: 'Живые состояния (вкл/выкл, открыто…)',
- show_signal: 'Показывать сигнал zigbee (LQI)',
-};
+import { langOf, t, type Lang } from './i18n';
class HouseplanCardEditor extends LitElement {
public hass?: any;
@@ -26,7 +18,7 @@ class HouseplanCardEditor extends LitElement {
this._config = config;
}
- /** Пространства из серверного конфига интеграции — не хардкод. */
+ /** Spaces come from the integration's server config — never hard-coded. */
private async _loadSpaces(): Promise {
if (this._spaces || this._spacesLoading || !this.hass) return;
this._spacesLoading = true;
@@ -43,8 +35,13 @@ class HouseplanCardEditor extends LitElement {
}
}
+ private get _lang(): Lang {
+ return langOf(this.hass, this._config?.language);
+ }
+
private get _schema(): any[] {
const spaces = this._spaces || [];
+ const L = this._lang;
return [
{ name: 'title', selector: { text: {} } },
spaces.length
@@ -53,6 +50,19 @@ class HouseplanCardEditor extends LitElement {
selector: { select: { mode: 'dropdown', options: spaces } },
}
: { name: 'default_floor', selector: { text: {} } },
+ {
+ name: 'language',
+ selector: {
+ select: {
+ mode: 'dropdown',
+ options: [
+ { value: '', label: t(L, 'editor.lang_auto') },
+ { value: 'en', label: t(L, 'editor.lang_en') },
+ { value: 'ru', label: t(L, 'editor.lang_ru') },
+ ],
+ },
+ },
+ },
{ name: 'icon_size', selector: { number: { min: 1, max: 6, step: 0.1, mode: 'box' } } },
{ name: 'show_temperature', selector: { boolean: {} } },
{ name: 'live_states', selector: { boolean: {} } },
@@ -63,11 +73,21 @@ class HouseplanCardEditor extends LitElement {
protected render() {
if (!this.hass || !this._config) return nothing;
this._loadSpaces();
+ const L = this._lang;
+ const labels: Record = {
+ title: t(L, 'editor.title'),
+ default_floor: t(L, 'editor.default_floor'),
+ language: t(L, 'editor.language'),
+ icon_size: t(L, 'editor.icon_size'),
+ show_temperature: t(L, 'editor.show_temperature'),
+ live_states: t(L, 'editor.live_states'),
+ show_signal: t(L, 'editor.show_signal'),
+ };
return html` LABELS[s.name] || s.name}
+ .computeLabel=${(s: any) => labels[s.name] || s.name}
@value-changed=${this._valueChanged}
> `;
}
diff --git a/src/houseplan-card.ts b/src/houseplan-card.ts
index bab6dcf..1223f11 100755
--- a/src/houseplan-card.ts
+++ b/src/houseplan-card.ts
@@ -1,10 +1,10 @@
/**
- * House Plan Card — интерактивный план дома как нативная Lovelace-карточка.
- * Источники конфигурации:
- * 1) СЕРВЕР (интеграция houseplan, WS houseplan/config/get) — пространства, планы,
- * комнаты, оверрайды устройств, виртуальные устройства. Координаты НОРМИРОВАННЫЕ (0..1).
- * 2) LEGACY-фолбэк — вшитые данные дачи (src/data/*), координаты в холсте 1489×1053.
- * Раскладка иконок хранится на сервере (houseplan/layout/*), fallback — localStorage.
+ * House Plan Card — an interactive house plan as a native Lovelace card.
+ * Configuration sources:
+ * 1) SERVER (the houseplan integration, WS houseplan/config/get) — spaces, plans,
+ * rooms, device overrides, virtual devices. Coordinates are NORMALIZED (0..1).
+ * 2) LEGACY fallback — baked-in country-house data (src/data/*), coordinates in a 1489×1053 canvas.
+ * The icon layout is stored on the server (houseplan/layout/*), fallback — localStorage.
*/
import { LitElement, html, svg, nothing, TemplateResult, PropertyValues } from 'lit';
import { EXCLUDED_DOMAINS } from './rules';
@@ -18,14 +18,15 @@ import type {
} from './types';
import './editor';
import { cardStyles } from './styles';
+import { langOf, t, type I18nKey } from './i18n';
-const CARD_VERSION = '1.10.0';
+const CARD_VERSION = '1.11.0';
const LS_KEY = 'houseplan_card_layout_v1';
-const LS_CFG = 'houseplan_card_cfg_v1'; // кэш серверного конфига+раскладки для мгновенного рендера
+const LS_CFG = 'houseplan_card_cfg_v1'; // cache of the server config+layout for instant rendering
const LS_ZOOM = 'houseplan_card_zoom_v1';
-const NORM_W = 1000; // ширина рендер-пространства для нормированных конфигов
+const NORM_W = 1000; // width of the render space for normalized configs
-const GRID_N = 240; // точек сетки по ширине плана (шаг вдвое меньше; старые узлы — подмножество новых, позиции сохраняются)
+const GRID_N = 240; // grid points across the plan width (half the previous step; old nodes are a subset of the new ones, positions are preserved)
type MarkupTool = 'draw' | 'erase' | 'delroom';
const fireEvent = (node: EventTarget, type: string, detail?: unknown) => {
@@ -68,38 +69,38 @@ class HouseplanCard extends LitElement {
private _toast = '';
private _toastTimer?: number;
- // --- редактор разметки комнат ---
+ // --- room markup editor ---
private _markup = false;
private _tool: MarkupTool = 'draw';
- private _path: number[][] = []; // текущий контур (рендер-единицы, вершины по сетке)
- private _pathSegs: (string | null)[] = []; // ключи сегментов, добавленных шагами контура
+ private _path: number[][] = []; // current outline (render units, vertices snapped to the grid)
+ private _pathSegs: (string | null)[] = []; // keys of the segments added by outline steps
private _cursorPt: number[] | null = null;
private _areaSel = '';
private _nameSel = '';
private _roomDialog = false;
- // зум/панорама плана (зум сохраняется по пространству локально)
+ // plan zoom/pan (zoom is saved per space, locally)
private _zoom = 1;
- private _view: { x: number; y: number; w: number; h: number } | null = null; // текущий viewBox SVG (vb-координаты)
+ private _view: { x: number; y: number; w: number; h: number } | null = null; // current SVG viewBox (vb coordinates)
private _zoomBySpace: Record = {};
private _pointers = new Map();
private _panStart: { sx: number; sy: number; vx: number; vy: number } | null = null;
private _pinchStart: { dist: number; zoom: number } | null = null;
private _suppressClick = false;
private _roViewport?: ResizeObserver;
- private _onboardingShown = false; // авто-диалог пространства показан один раз за сессию
+ private _onboardingShown = false; // the auto space dialog is shown once per session
private _infoCard: DevItem | null = null;
private _markerDialog: {
- devId?: string; // редактируемый значок (если есть)
+ devId?: string; // the icon being edited (if any)
name: string;
binding: string; // 'device:' | 'entity:' | 'virtual'
bindingFilter: string;
- icon: string; // '' = авто
+ icon: string; // '' = auto
model: string;
link: string;
description: string;
pdfs: PdfRef[];
- room: string; // 'space#area' для виртуального
+ room: string; // 'space#area' for a virtual one
busy: boolean;
} | null = null;
private _spaceDialog: {
@@ -173,7 +174,7 @@ class HouseplanCard extends LitElement {
}
}
- /** Убрать последнюю поставленную точку (и её линию, если она была добавлена этим шагом). */
+ /** Remove the last placed point (and its line, if it was added by that step). */
private _undoPoint(): void {
if (!this._path.length) return;
if (this._path.length === 1) {
@@ -204,7 +205,7 @@ class HouseplanCard extends LitElement {
}
public static getStubConfig(): Partial {
- return { type: 'custom:houseplan-card', title: 'План дома' };
+ return { type: 'custom:houseplan-card' };
}
public setConfig(config: CardConfig): void {
@@ -215,8 +216,8 @@ class HouseplanCard extends LitElement {
} catch {
this._zoomBySpace = {};
}
- // мгновенный рендер из кэша (stale-while-revalidate): показать план и значки
- // сразу, не дожидаясь ответа сервера — свежие данные догрузятся в фоне.
+ // instant render from cache (stale-while-revalidate): show the plan and icons
+ // right away, without waiting for the server response — fresh data will load in the background.
try {
const c = JSON.parse(localStorage.getItem(LS_CFG) || 'null');
if (c && c.config && Array.isArray(c.config.spaces)) {
@@ -232,7 +233,7 @@ class HouseplanCard extends LitElement {
}
}
- /** Сохранить снимок конфига+раскладки в localStorage для мгновенного старта. */
+ /** Save a snapshot of the config+layout to localStorage for an instant start. */
private _cacheSnapshot(): void {
if (!this._serverCfg) return;
try {
@@ -246,14 +247,14 @@ class HouseplanCard extends LitElement {
return 12;
}
- // ================= РЕЗОЛВ МОДЕЛИ (серверная конфигурация) =================
+ // ================= MODEL RESOLUTION (server configuration) =================
- /** Есть ли серверная конфигурация с пространствами (иначе — онбординг). */
+ /** Whether a server configuration with spaces exists (otherwise — onboarding). */
private get _norm(): boolean {
return !!(this._serverCfg && this._serverCfg.spaces.length);
}
- /** Пространства в рендер-единицах (NORM_W × NORM_W/aspect). */
+ /** Spaces in render units (NORM_W × NORM_W/aspect). */
private get _model(): SpaceModel[] {
if (!this._serverCfg) return [];
return this._serverCfg.spaces.map((s: any) => {
@@ -327,7 +328,7 @@ class HouseplanCard extends LitElement {
this._roViewport.observe(stage);
}
if (stage && !this._view) this._refitView();
- // онбординг: на пустом серверном конфиге сразу открываем диалог пространства
+ // onboarding: on an empty server config, open the space dialog right away
if (
this._serverStorage &&
this._loadOk &&
@@ -340,7 +341,7 @@ class HouseplanCard extends LitElement {
}
}
- // ================= сервер: конфиг + раскладка =================
+ // ================= server: config + layout =================
private async _loadFromServer(): Promise {
this._loading = true;
@@ -356,7 +357,7 @@ class HouseplanCard extends LitElement {
this._serverCfg = cfg && Array.isArray(cfg.spaces) ? cfg : null;
this._cfgRev = cfgResp?.rev || 0;
this._layout = layResp?.layout || {};
- // live-синхронизация: конфиг изменён в другом окне → перечитать
+ // live sync: the config was changed in another window → re-read it
if (!this._unsubCfg) {
this._unsubCfg = await this.hass.connection.subscribeEvents((ev: any) => {
if ((ev?.data?.rev ?? -1) !== this._cfgRev) this._reloadConfigOnly();
@@ -368,7 +369,7 @@ class HouseplanCard extends LitElement {
this._cacheSnapshot();
this._restoreZoom();
} catch (e) {
- // не последняя попытка — молча ждём следующего обновления hass (прогрев WS)
+ // not the last attempt — silently wait for the next hass update (WS warm-up)
if (this._loadTries >= 8) {
this._serverStorage = false;
this._serverCfg = null;
@@ -404,7 +405,7 @@ class HouseplanCard extends LitElement {
private _persistLayout = debounce(() => {
if (this._serverStorage) {
- // точечные обновления: не затираем позиции, изменённые в других окнах
+ // point-wise updates: do not overwrite positions changed in other windows
const ids = [...this._dirtyPos];
this._dirtyPos.clear();
for (const id of ids) {
@@ -412,7 +413,7 @@ class HouseplanCard extends LitElement {
if (!pos) continue;
this.hass
.callWS({ type: 'houseplan/layout/update', device_id: id, pos })
- .catch((e: any) => this._showToast('Не удалось сохранить позицию: ' + (e?.message || e)));
+ .catch((e: any) => this._showToast(this._t('toast.pos_save_failed', { err: this._errText(e) })));
}
this._cacheSnapshot();
} else {
@@ -420,14 +421,14 @@ class HouseplanCard extends LitElement {
}
}, 600);
- // ================= устройства из реестров =================
+ // ================= devices from the registries =================
private _maybeRebuildDevices(): void {
const h = this.hass;
if (!h?.devices || !h?.entities || !h?.areas) return;
const sig =
Object.keys(h.devices).length + ':' + Object.keys(h.entities).length + ':' +
- Object.keys(h.areas).length + ':' + (this._norm ? 'n' : 'l');
+ Object.keys(h.areas).length + ':' + (this._norm ? 'n' : 'l') + ':' + langOf(h, this._config?.language);
if (sig === this._regSignature && this._devices.length) return;
this._regSignature = sig;
this._devices = buildDevices({
@@ -440,11 +441,12 @@ class HouseplanCard extends LitElement {
excluded: this._excluded,
showAll: this._showAll,
firstSpaceId: this._model[0]?.id || '',
+ loc: (k) => this._t(k),
});
this._defPos = this._defaultPositions();
}
- /** Курирование + группы света + оверрайды + виртуальные устройства. */
+ /** Curation + light groups + overrides + virtual devices. */
private get _markers(): Marker[] {
return this._serverCfg?.markers || [];
}
@@ -460,9 +462,9 @@ class HouseplanCard extends LitElement {
return averageLqi(vals);
}
- // ================= позиции =================
+ // ================= positions =================
- /** Ограничивающий прямоугольник комнаты (rect или полигон) в рендер-единицах. */
+ /** Bounding rectangle of a room (rect or polygon) in render units. */
private _roomBounds(r: RoomCfg): { x: number; y: number; w: number; h: number } {
if (r.poly && r.poly.length) {
const xs = r.poly.map((p) => p[0]);
@@ -477,7 +479,7 @@ class HouseplanCard extends LitElement {
private _defaultPositions(): Record {
const map: Record = {};
const iconPct = this._config?.icon_size ?? 2.5;
- const minDist = (iconPct / 100) * NORM_W * 1.3; // не ближе диаметра значка + запас
+ const minDist = (iconPct / 100) * NORM_W * 1.3; // no closer than the icon diameter + a margin
for (const s of this._model) {
for (const r of s.rooms) {
if (!r.area) continue;
@@ -502,7 +504,7 @@ class HouseplanCard extends LitElement {
return map;
}
- /** Позиция устройства в рендер-единицах текущего пространства. */
+ /** Device position in render units of the current space. */
private _pos(d: DevItem): { x: number; y: number } {
const s = this._spaceModel(d.space);
const saved = this._layout[d.id];
@@ -523,7 +525,7 @@ class HouseplanCard extends LitElement {
private _savePos(d: DevItem, x: number, y: number): void {
if (this._norm) {
- // центр иконки привязывается к узлам той же сетки, что и разметка комнат
+ // the icon center snaps to the nodes of the same grid as the room markup
const g = this._gridPitch;
const gx = Math.round(x / g) * g;
const gy = Math.round(y / g) * g;
@@ -539,7 +541,7 @@ class HouseplanCard extends LitElement {
this._persistLayout();
}
- // ================= живые состояния =================
+ // ================= live states =================
private _stateClass(d: DevItem): string {
if (!this._config?.live_states) return '';
@@ -566,11 +568,11 @@ class HouseplanCard extends LitElement {
return tempFor(this.hass, d.entities);
}
- // ================= взаимодействие =================
+ // ================= interaction =================
private _openMoreInfo(entityId?: string): void {
if (!entityId) {
- this._showToast('У устройства нет подходящей сущности');
+ this._showToast(this._t('toast.no_entity'));
return;
}
fireEvent(this, 'hass-more-info', { entityId });
@@ -583,23 +585,28 @@ class HouseplanCard extends LitElement {
this._infoCard = d;
}
+ /** Translate a key in the card's current language. */
+ private _t(key: I18nKey, vars?: Record): string {
+ return t(langOf(this.hass, this._config?.language), key, vars);
+ }
+
private get _stageEl(): HTMLElement | null {
return this.renderRoot.querySelector('.stage') as HTMLElement | null;
}
- /** Соотношение сторон сцены (ширина/высота, px). */
+ /** Aspect ratio of the scene (width/height, px). */
private _stageAspect(): number {
const s = this._stageEl;
const vb = this._spaceModel().vb;
return s && s.clientHeight ? s.clientWidth / s.clientHeight : vb[2] / vb[3];
}
- /** Текущий view с фолбэком на полный fit. */
+ /** Current view with a fallback to the full fit. */
private _viewOr(vb: number[]): { x: number; y: number; w: number; h: number } {
return this._view && this._view.w ? this._view : fitView(vb, this._stageAspect());
}
- /** Экран (sx,sy относительно сцены, px) → координаты vb по текущему view. */
+ /** Screen (sx,sy relative to the scene, px) → vb coordinates per the current view. */
private _screenToVb(sx: number, sy: number): number[] {
const s = this._stageEl;
const v = this._viewOr(this._spaceModel().vb);
@@ -607,7 +614,7 @@ class HouseplanCard extends LitElement {
return [v.x + (sx / w) * v.w, v.y + (sy / h) * v.h];
}
- /** Ограничить view пределами fit (контент всегда покрывает сцену). */
+ /** Clamp the view to the fit bounds (the content always covers the scene). */
private _clampView(
v: { x: number; y: number; w: number; h: number },
fit: { x: number; y: number; w: number; h: number },
@@ -620,7 +627,7 @@ class HouseplanCard extends LitElement {
};
}
- /** Установить зум (центр — точка vb cx,cy либо центр текущего view). */
+ /** Set the zoom (centered on vb point cx,cy, or on the center of the current view). */
private _applyView(zoom: number, cx?: number, cy?: number): void {
const vb = this._spaceModel().vb;
const fit = fitView(vb, this._stageAspect());
@@ -633,7 +640,7 @@ class HouseplanCard extends LitElement {
this._view = this._clampView({ x: ccx - w / 2, y: ccy - h / 2, w, h }, fit);
}
- /** Пересчитать view под новый размер сцены, сохранив зум и центр. */
+ /** Recompute the view for a new scene size, preserving zoom and center. */
private _refitView(): void {
if (!this._stageEl) return;
const cur = this._view;
@@ -641,7 +648,7 @@ class HouseplanCard extends LitElement {
this.requestUpdate();
}
- /** Изменить зум, удерживая точку (sx,sy относительно сцены) на месте. */
+ /** Change the zoom while keeping the point (sx,sy relative to the scene) in place. */
private _zoomAt(sx: number, sy: number, newZoom: number): void {
const stage = this._stageEl;
if (!stage) return;
@@ -679,7 +686,7 @@ class HouseplanCard extends LitElement {
this._saveZoom();
}
- /** Сохранить текущий зум пространства в localStorage. */
+ /** Save the current space zoom to localStorage. */
private _saveZoom(): void {
this._zoomBySpace = { ...this._zoomBySpace, [this._space]: this._zoom };
try {
@@ -689,7 +696,7 @@ class HouseplanCard extends LitElement {
}
}
- /** Восстановить сохранённый зум пространства и центрировать план. */
+ /** Restore the saved space zoom and center the plan. */
private _restoreZoom(): void {
const z = this._zoomBySpace[this._space] || 1;
this._zoom = z;
@@ -703,7 +710,7 @@ class HouseplanCard extends LitElement {
}
private _stagePointerDown(ev: PointerEvent): void {
- // не мешать перетаскиванию иконок и рисованию разметки
+ // do not interfere with icon dragging and markup drawing
if (this._drag || this._markup) return;
if ((ev.target as HTMLElement).closest('.dev')) return;
this._pointers.set(ev.pointerId, { x: ev.clientX, y: ev.clientY });
@@ -761,7 +768,7 @@ class HouseplanCard extends LitElement {
if (this._pointers.size < 2) this._pinchStart = null;
if (this._pointers.size === 0) {
this._panStart = null;
- // сбросить подавление клика на следующий тик (чтобы click после pan не сработал)
+ // reset click suppression on the next tick (so that a click right after a pan does not fire)
setTimeout(() => (this._suppressClick = false), 0);
}
}
@@ -772,7 +779,7 @@ class HouseplanCard extends LitElement {
}
private _pointerDown(ev: PointerEvent, d: DevItem): void {
- if (this._markup) return; // в режиме разметки значки не тащим
+ if (this._markup) return; // in markup mode icons are not dragged
ev.preventDefault();
const p = this._pos(d);
this._drag = { id: d.id, sx: ev.clientX, sy: ev.clientY, ox: p.x, oy: p.y, moved: false };
@@ -807,7 +814,7 @@ class HouseplanCard extends LitElement {
}
private _resetLayout(): void {
- if (!confirm('Сбросить позиции всех иконок к авто-раскладке?')) return;
+ if (!confirm(this._t('confirm.reset_layout'))) return;
this._layout = {};
this._persistLayout();
}
@@ -825,7 +832,7 @@ class HouseplanCard extends LitElement {
this._tip = { x: ev.clientX, y: ev.clientY, title, meta, lqi };
}
- // ================= РЕДАКТОР РАЗМЕТКИ КОМНАТ =================
+ // ================= ROOM MARKUP EDITOR =================
private get _gridPitch(): number {
return NORM_W / GRID_N;
@@ -840,7 +847,7 @@ class HouseplanCard extends LitElement {
return sp ? NORM_W / sp.aspect : NORM_W;
}
- /** Сегменты текущего пространства в рендер-единицах. */
+ /** Segments of the current space in render units. */
private get _segments(): number[][] {
const sp = this._curSpaceCfg;
const H = this._spaceH;
@@ -849,7 +856,7 @@ class HouseplanCard extends LitElement {
private _toggleMarkup(): void {
if (!this._norm) {
- this._showToast('Разметка доступна после переноса конфига на сервер (режим правки → «На сервер»)');
+ this._showToast(this._t('toast.markup_needs_server'));
return;
}
this._markup = !this._markup;
@@ -886,16 +893,16 @@ class HouseplanCard extends LitElement {
})
.catch((e: any) => {
if (e?.code === 'conflict') {
- this._showToast('Конфиг изменён в другом окне — данные обновлены, повторите последнее действие');
+ this._showToast(this._t('toast.conflict'));
this._cancelPath();
this._reloadConfigOnly();
} else {
- this._showToast('Не удалось сохранить конфиг: ' + (e?.message || e));
+ this._showToast(this._t('toast.cfg_save_failed', { err: this._errText(e) }));
}
});
}, 500);
- /** Добавить сегмент (рендер-единицы) в каркас пространства (без дублей). true = новый. */
+ /** Add a segment (render units) to the space skeleton (no duplicates). true = new. */
private _addSegment(a: number[], b: number[]): boolean {
const sp = this._curSpaceCfg;
if (!sp) return false;
@@ -956,7 +963,7 @@ class HouseplanCard extends LitElement {
const space = this._spaceModel();
const room = [...space.rooms].reverse().find((r) => this._pointInRoom(raw, r));
if (!room) return;
- if (!confirm(`Удалить комнату «${room.name}»?`)) return;
+ if (!confirm(this._t('confirm.delete_room', { name: room.name }))) return;
const sp = this._curSpaceCfg;
sp.rooms = sp.rooms.filter((r: any) => r.id !== room.id);
this._saveConfig();
@@ -965,7 +972,7 @@ class HouseplanCard extends LitElement {
this.requestUpdate();
return;
}
- // draw: клики по точкам сетки, пары точек соединяются линией
+ // draw: clicks on grid points, pairs of points get connected with a line
const pt = this._snap(raw);
if (!this._path.length) {
this._path = [pt];
@@ -973,11 +980,11 @@ class HouseplanCard extends LitElement {
return;
}
const last = this._path[this._path.length - 1];
- if (this._samePt(pt, last)) return; // повторный клик по той же точке
+ if (this._samePt(pt, last)) return; // repeated click on the same point
const added = this._addSegment(last, pt);
this._pathSegs = [...this._pathSegs, added ? this._segKey(last, pt) : null];
this._path = [...this._path, pt];
- // замыкание: клик по первой вершине → диалог сохранения
+ // closing the outline: a click on the first vertex → the save dialog
if (this._path.length >= 4 && this._samePt(pt, this._path[0])) {
this._cursorPt = null;
this._nameSel = '';
@@ -997,13 +1004,13 @@ class HouseplanCard extends LitElement {
this._cursorPt = this._snap(this._svgPoint(ev));
}
- /** Сохранить комнату с обязательной привязкой к зоне HA. */
+ /** Save a room with a mandatory binding to an HA area. */
private _saveRoom(): void {
if (!this._areaSel) return;
this._commitRoom();
}
- /** Сохранить декоративную комнату без зоны (нужно только имя). */
+ /** Save a decorative room without an area (only a name is required). */
private _saveRoomNoArea(): void {
if (!this._nameSel.trim()) return;
this._areaSel = '';
@@ -1015,11 +1022,11 @@ class HouseplanCard extends LitElement {
const sp = this._curSpaceCfg;
if (!sp) return;
const H = this._spaceH;
- const verts = this._path.slice(0, -1); // без дублированной замыкающей
+ const verts = this._path.slice(0, -1); // without the duplicated closing vertex
const areaName = this._areaSel ? this.hass.areas[this._areaSel]?.name : '';
sp.rooms.push({
id: 'r' + Date.now().toString(36),
- name: this._nameSel || areaName || 'Комната',
+ name: this._nameSel || areaName || this._t('room.default_name'),
area: this._areaSel || null,
poly: verts.map((p) => [p[0] / NORM_W, p[1] / H]),
});
@@ -1032,8 +1039,8 @@ class HouseplanCard extends LitElement {
this._roomDialog = false;
this._regSignature = '';
this._maybeRebuildDevices();
- // авто-добавление значков устройств зоны + ФИКСАЦИЯ их позиций в раскладке,
- // чтобы при смене порядка в реестре HA значки не перетасовывались.
+ // auto-add the area's device icons + PIN their positions in the layout,
+ // so that icons do not get reshuffled when the order in the HA registry changes.
let added = 0;
if (boundArea) {
const aspect = this._serverCfg?.spaces.find((x: any) => x.id === this._space)?.aspect || 1;
@@ -1042,7 +1049,7 @@ class HouseplanCard extends LitElement {
for (const d of this._devices) {
if (d.area !== boundArea || d.space !== this._space) continue;
added++;
- if (this._layout[d.id]) continue; // размещено вручную — не трогаем
+ if (this._layout[d.id]) continue; // placed manually — leave it alone
const dp = this._defPos[d.id];
if (!dp) continue;
next[d.id] = { s: this._space, x: dp.x / NORM_W, y: dp.y / H2 };
@@ -1054,8 +1061,8 @@ class HouseplanCard extends LitElement {
const roomsN = this._model.find((s) => s.id === this._space)?.rooms.length || 0;
this._showToast(
boundArea
- ? `Комната сохранена (${roomsN}). Устройств добавлено: ${added}. Обведите следующую или выйдите из разметки.`
- : `Комната сохранена (${roomsN}, без зоны). Обведите следующую или выйдите из разметки.`,
+ ? this._t('toast.room_saved', { n: roomsN, added })
+ : this._t('toast.room_saved_no_area', { n: roomsN }),
);
}
@@ -1066,13 +1073,13 @@ class HouseplanCard extends LitElement {
this._roomDialog = false;
}
- /** Отмена в диалоге: контур снова открыт (замыкающая точка снимается). */
+ /** Cancel in the dialog: the outline is open again (the closing point is removed). */
private _roomDialogCancel(): void {
this._roomDialog = false;
this._undoPoint();
}
- /** Зоны HA, ещё не назначенные ни одной комнате конфига. */
+ /** HA areas not yet assigned to any room in the config. */
private get _freeAreas(): any[] {
const used = new Set();
for (const sp of this._serverCfg?.spaces || [])
@@ -1082,11 +1089,11 @@ class HouseplanCard extends LitElement {
.sort((a, b) => (a.name || '').localeCompare(b.name || ''));
}
- // ================= РЕДАКТОР УСТРОЙСТВ (маркеры) =================
+ // ================= DEVICE EDITOR (markers) =================
private _openMarkerDialog(d?: DevItem): void {
if (!this._norm) {
- this._showToast('Редактирование устройств доступно после переноса конфига на сервер');
+ this._showToast(this._t('toast.marker_needs_server'));
return;
}
if (d) {
@@ -1111,7 +1118,7 @@ class HouseplanCard extends LitElement {
}
}
- /** Кандидаты привязки: устройства HA + группы/хелпер-сущности, минус уже размещённые. */
+ /** Binding candidates: HA devices + group/helper entities, minus the ones already placed. */
private _bindingCandidates(): { value: string; label: string; sub: string }[] {
const h = this.hass;
const taken = new Set();
@@ -1120,22 +1127,22 @@ class HouseplanCard extends LitElement {
if (dev.bindingKind === 'device' && dev.bindingRef) taken.add('device:' + dev.bindingRef);
if (dev.bindingKind === 'entity' && dev.bindingRef) taken.add('entity:' + dev.bindingRef);
}
- // дедуп как на плане: скрыть устройства с тем же «имя|area», что уже показаны (дубли Tuya)
+ // dedup as on the plan: hide devices with the same “name|area” as already shown ones (Tuya duplicates)
const shownKeys = new Set();
for (const dev of this._devices) {
if (dev.bindingKind === 'device' && dev.name) shownKeys.add(dev.name.trim() + '|' + (dev.area || ''));
}
const list: { value: string; label: string; sub: string }[] = [];
- // устройства (в т.ч. Z2M-группы model=Group)
+ // devices (incl. Z2M groups with model=Group)
for (const dev of Object.values(h.devices)) {
if (dev.entry_type === 'service') continue;
const v = 'device:' + dev.id;
if (taken.has(v)) continue;
const name = (dev.name_by_user || dev.name || dev.id).trim();
if (v !== this._markerDialog?.binding && shownKeys.has(name + '|' + (dev.area_id || ''))) continue;
- list.push({ value: v, label: name, sub: (dev.model || 'устройство') + (dev.model === 'Group' ? ' · Z2M-группа' : '') });
+ list.push({ value: v, label: name, sub: (dev.model || this._t('marker.sub_device')) + (dev.model === 'Group' ? this._t('marker.sub_z2m_group') : '') });
}
- // group/helper-сущности без «своего» физического устройства
+ // group/helper entities without a physical device of their own
const helperPlatforms = new Set([
'group', 'template', 'derivative', 'min_max', 'threshold', 'integration',
'statistics', 'trend', 'utility_meter', 'tod', 'switch_as_x', 'schedule',
@@ -1151,7 +1158,7 @@ class HouseplanCard extends LitElement {
list.push({
value: v,
label: reg.name || st?.attributes?.friendly_name || eid,
- sub: eid.split('.')[0] + ' · ' + (reg.platform === 'group' ? 'группа' : 'хелпер'),
+ sub: eid.split('.')[0] + ' · ' + (reg.platform === 'group' ? this._t('marker.sub_group') : this._t('marker.sub_helper')),
});
}
const f = (this._markerDialog?.bindingFilter || '').toLowerCase().trim();
@@ -1162,7 +1169,7 @@ class HouseplanCard extends LitElement {
return filtered.slice(0, 200);
}
- /** Список комнат всех пространств для виртуального устройства. */
+ /** List of rooms across all spaces for a virtual device. */
private _allRoomsFlat(): { value: string; label: string }[] {
const res: { value: string; label: string }[] = [];
for (const sp of this._serverCfg?.spaces || []) {
@@ -1174,13 +1181,13 @@ class HouseplanCard extends LitElement {
return res;
}
- /** Читаемый текст ошибки (никогда не «[object Object]»). */
+ /** Readable error text (never “[object Object]”). */
private _errText(e: any): string {
- if (!e) return 'неизвестная ошибка';
+ if (!e) return this._t('err.unknown');
if (typeof e === 'string') return e;
if (e.message) return e.message;
if (e.error) return e.error;
- if (e.code != null) return 'код ' + e.code;
+ if (e.code != null) return this._t('err.code', { code: e.code });
try {
return JSON.stringify(e);
} catch {
@@ -1189,8 +1196,8 @@ class HouseplanCard extends LitElement {
}
/**
- * Загрузка файлов-инструкций через HTTP (multipart) — не через WebSocket, у которого лимит
- * размера сообщения рвёт соединение на больших PDF.
+ * Manual files are uploaded via HTTP (multipart) — not via WebSocket, whose message size
+ * limit breaks the connection on large PDFs.
*/
private async _pickMarkerFiles(ev: Event): Promise {
const input = ev.target as HTMLInputElement;
@@ -1204,7 +1211,7 @@ class HouseplanCard extends LitElement {
const fd = new FormData();
fd.append('marker_id', mid);
fd.append('file', file, file.name);
- // fetchWithAuth сам обновляет протухший access_token; фолбэк — сырой токен
+ // fetchWithAuth refreshes a stale access_token itself; the fallback is the raw token
const resp: Response = this.hass?.fetchWithAuth
? await this.hass.fetchWithAuth('/api/houseplan/upload', { method: 'POST', body: fd })
: await fetch('/api/houseplan/upload', {
@@ -1217,21 +1224,21 @@ class HouseplanCard extends LitElement {
const json = await resp.json().catch(() => ({}));
if (!resp.ok || json.error) {
const map: Record = {
- too_large: 'файл больше ' + (json.max_mb || 25) + ' МБ',
- bad_ext: 'недопустимый тип (нужен PDF/изображение)',
- unauthorized: 'нужны права администратора',
+ too_large: this._t('err.too_large', { mb: json.max_mb || 25 }),
+ bad_ext: this._t('err.bad_ext'),
+ unauthorized: this._t('err.unauthorized'),
};
throw new Error(map[json.error] || json.error || 'HTTP ' + resp.status);
}
uploaded.push({ name: json.name || file.name, url: json.url });
} catch (e: any) {
- this._showToast('Файл «' + file.name + '» не загружен: ' + this._errText(e));
+ this._showToast(this._t('toast.file_failed', { name: file.name, err: this._errText(e) }));
}
}
- // диалог мог закрыться за время загрузки — добавляем, только если он ещё открыт
+ // the dialog might have closed during the upload — add only if it is still open
if (uploaded.length && this._markerDialog) {
this._markerDialog = { ...this._markerDialog, pdfs: [...this._markerDialog.pdfs, ...uploaded] };
- this._showToast('Прикреплено файлов: ' + uploaded.length);
+ this._showToast(this._t('toast.files_attached', { n: uploaded.length }));
}
}
@@ -1247,16 +1254,16 @@ class HouseplanCard extends LitElement {
const dlg = this._markerDialog;
if (!dlg || dlg.busy) return;
if (dlg.binding === 'virtual' && !dlg.name.trim()) {
- this._showToast('Укажите имя виртуального устройства');
+ this._showToast(this._t('toast.virtual_name_required'));
return;
}
this._markerDialog = { ...dlg, busy: true };
try {
const cfg = this._serverCfg!;
cfg.markers = cfg.markers || [];
- // определить id маркера
+ // determine the marker id
let id: string;
- // комната (выбранная вручную) переопределяет пространство/зону для любого значка
+ // a manually chosen room overrides the space/area for any icon
const [roomSp, roomAr] = dlg.room ? dlg.room.split('#') : ['', ''];
let space: string | null = roomSp || null;
let area: string | null = roomAr || null;
@@ -1273,20 +1280,20 @@ class HouseplanCard extends LitElement {
description: dlg.description.trim() || null,
pdfs: dlg.pdfs,
};
- // сохраняем выбор комнаты (для виртуальных всегда; для привязанных — если выбрана)
+ // save the room choice (always for virtual ones; for bound ones — if chosen)
if (dlg.binding === 'virtual' || dlg.room) {
marker.space = space;
marker.area = area;
}
- // сменилась комната → переставить значок в её центр
+ // the room changed → move the icon to its center
const prevDev = oldId ? this._devices.find((x) => x.id === oldId) : null;
const roomChanged = !!dlg.room && prevDev != null && (prevDev.space !== space || prevDev.area !== area);
- // удалить прежний маркер (по старому id и по новому id)
+ // remove the previous marker (by the old id and by the new id)
cfg.markers = cfg.markers.filter((m) => m.id !== id && m.id !== oldId);
cfg.markers.push(marker);
- // позиция: новый значок ИЛИ сменилась комната → поставить в центр комнаты/пространства.
- // Пишем ТОЧЕЧНО (layout/update), а не всей раскладкой — полный layout/set затирает
- // позиции, изменённые в других окнах (инцидент v1.4.4).
+ // position: a new icon OR the room changed → place it at the center of the room/space.
+ // Write POINT-WISE (layout/update), not the whole layout — a full layout/set overwrites
+ // positions changed in other windows (the v1.4.4 incident).
let newPos: { s: string; x: number; y: number } | null = null;
if (!this._layout[id] || roomChanged) {
const spm = this._spaceModel(space || undefined);
@@ -1302,17 +1309,17 @@ class HouseplanCard extends LitElement {
await this._saveConfigNow();
if (newPos) await this.hass.callWS({ type: 'houseplan/layout/update', device_id: id, pos: newPos });
if (oldId && oldId !== id) {
- // перепривязка сменила id значка — подчистить старую позицию
+ // rebinding changed the icon id — clean up the old position
delete this._layout[oldId];
await this.hass.callWS({ type: 'houseplan/layout/delete', device_id: oldId }).catch(() => undefined);
}
this._markerDialog = null;
this._regSignature = '';
this._maybeRebuildDevices();
- this._showToast('Устройство сохранено');
+ this._showToast(this._t('toast.marker_saved'));
} catch (e: any) {
this._markerDialog = { ...this._markerDialog!, busy: false };
- this._showToast('Ошибка: ' + this._errText(e));
+ this._showToast(this._t('toast.error', { err: this._errText(e) }));
}
}
@@ -1320,14 +1327,14 @@ class HouseplanCard extends LitElement {
const dlg = this._markerDialog;
if (!dlg) return;
const d = dlg.devId ? this._devices.find((x) => x.id === dlg.devId) : null;
- const label = dlg.name || 'устройство';
- if (!confirm(`Убрать «${label}» с плана?`)) return;
+ const label = dlg.name || this._t('device.fallback');
+ if (!confirm(this._t('confirm.remove_marker', { name: label }))) return;
const cfg = this._serverCfg!;
cfg.markers = cfg.markers || [];
if (d && d.bindingKind === 'virtual') {
cfg.markers = cfg.markers.filter((m) => m.id !== d.id);
} else if (d && d.marker) {
- // был явный маркер → просто скрыть либо удалить: скрываем (авто вернётся если это авто-устройство)
+ // there was an explicit marker → either hide or delete: we hide (the auto entry comes back if it is an auto device)
cfg.markers = cfg.markers.filter((m) => m.id !== d.id);
if (d.bindingKind === 'device' && d.bindingRef) {
cfg.markers.push({ id: d.id, binding: 'device:' + d.bindingRef, hidden: true });
@@ -1342,16 +1349,16 @@ class HouseplanCard extends LitElement {
try {
await this._saveConfigNow();
if (d && d.bindingKind === 'virtual' && this._layout[d.id]) {
- // виртуальный удалён совсем → его позиция больше не нужна
+ // the virtual one is deleted for good → its position is no longer needed
delete this._layout[d.id];
await this.hass.callWS({ type: 'houseplan/layout/delete', device_id: d.id }).catch(() => undefined);
}
this._markerDialog = null;
this._regSignature = '';
this._maybeRebuildDevices();
- this._showToast('Устройство убрано с плана');
+ this._showToast(this._t('toast.marker_removed'));
} catch (e: any) {
- this._showToast('Ошибка: ' + this._errText(e));
+ this._showToast(this._t('toast.error', { err: this._errText(e) }));
}
}
@@ -1360,11 +1367,11 @@ class HouseplanCard extends LitElement {
return { s: space, x: x / NORM_W, y: y / (NORM_W / aspect) };
}
- // ================= УПРАВЛЕНИЕ ПРОСТРАНСТВАМИ =================
+ // ================= SPACE MANAGEMENT =================
private _openSpaceDialog(mode: 'edit' | 'create', spaceId?: string): void {
if (!this._serverStorage || !this._serverCfg) {
- this._showToast('Интеграция House Plan не установлена — управление недоступно');
+ this._showToast(this._t('toast.integration_missing'));
return;
}
if (mode === 'edit') {
@@ -1376,7 +1383,7 @@ class HouseplanCard extends LitElement {
}
}
- /** Выбор файла подложки: читаем base64 и определяем пропорции. */
+ /** Background file selection: read base64 and determine the aspect ratio. */
private async _pickPlanFile(ev: Event): Promise {
const input = ev.target as HTMLInputElement;
const file = input.files?.[0];
@@ -1386,14 +1393,14 @@ class HouseplanCard extends LitElement {
};
const ext = extMap[file.type] || (file.name.toLowerCase().endsWith('.svg') ? 'svg' : '');
if (!ext) {
- this._showToast('Поддерживаются SVG, PNG, JPG, WebP');
+ this._showToast(this._t('toast.plan_formats'));
return;
}
const buf = new Uint8Array(await file.arrayBuffer());
let bin = '';
for (let i = 0; i < buf.length; i += 32768) bin += String.fromCharCode(...buf.subarray(i, i + 32768));
const b64 = btoa(bin);
- // пропорции: рендерим в Image
+ // aspect ratio: render into an Image
const url = URL.createObjectURL(file);
const aspect = await new Promise((res) => {
const img = new Image();
@@ -1409,7 +1416,7 @@ class HouseplanCard extends LitElement {
const d = this._spaceDialog;
if (!d || d.busy || !d.title.trim()) return;
if (!d.planFile && !d.planUrl) {
- this._showToast('Загрузите подложку — план этажа обязателен');
+ this._showToast(this._t('toast.plan_required'));
return;
}
const wasFirst = d.mode === 'create' && (this._serverCfg?.spaces.length || 0) === 0;
@@ -1445,18 +1452,18 @@ class HouseplanCard extends LitElement {
this._regSignature = '';
this._maybeRebuildDevices();
if (wasFirst) {
- // ведём пользователя дальше: сразу в режим разметки комнат
+ // guide the user onward: straight into room markup mode
this._markup = true;
this._tool = 'draw';
this._path = [];
this._cursorPt = null;
- this._showToast('Пространство добавлено. Обведите комнаты: кликайте по точкам сетки и замкните контур.');
+ this._showToast(this._t('toast.space_added_onboard'));
} else {
- this._showToast(d.mode === 'create' ? 'Пространство добавлено' : 'Пространство сохранено');
+ this._showToast(d.mode === 'create' ? this._t('toast.space_added') : this._t('toast.space_saved'));
}
} catch (e: any) {
this._spaceDialog = { ...this._spaceDialog!, busy: false };
- this._showToast('Ошибка: ' + this._errText(e));
+ this._showToast(this._t('toast.error', { err: this._errText(e) }));
}
}
@@ -1464,7 +1471,7 @@ class HouseplanCard extends LitElement {
const d = this._spaceDialog;
if (!d || d.mode !== 'edit') return;
const sp = this._serverCfg!.spaces.find((x: any) => x.id === d.spaceId);
- if (!confirm(`Удалить пространство «${sp.title}» со всеми комнатами и разметкой?`)) return;
+ if (!confirm(this._t('confirm.delete_space', { title: sp.title }))) return;
this._serverCfg!.spaces = this._serverCfg!.spaces.filter((x: any) => x.id !== d.spaceId);
try {
await this._saveConfigNow();
@@ -1472,13 +1479,13 @@ class HouseplanCard extends LitElement {
if (this._space === d.spaceId) this._space = this._serverCfg!.spaces[0]?.id || '';
this._regSignature = '';
this._maybeRebuildDevices();
- this._showToast('Пространство удалено');
+ this._showToast(this._t('toast.space_deleted'));
} catch (e: any) {
- this._showToast('Ошибка удаления: ' + this._errText(e));
+ this._showToast(this._t('toast.delete_failed', { err: this._errText(e) }));
}
}
- /** Немедленное сохранение конфига с ревизией (без дебаунса). */
+ /** Immediate config save with a revision bump (no debounce). */
private async _saveConfigNow(): Promise {
const r = await this.hass.callWS({
type: 'houseplan/config/set', config: this._serverCfg, expected_rev: this._cfgRev,
@@ -1487,7 +1494,7 @@ class HouseplanCard extends LitElement {
}
- // ================= рендер =================
+ // ================= render =================
protected render(): TemplateResult | typeof nothing {
if (!this._config || !this.hass) return nothing;
@@ -1495,17 +1502,17 @@ class HouseplanCard extends LitElement {
if (!model.length) {
return html`
t.stopPropagation()}>
`}}Nt.properties={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},_markup:{state:!0},_tool:{state:!0},_path:{state:!0},_cursorPt:{state:!0},_areaSel:{state:!0},_nameSel:{state:!0},_roomDialog:{state:!0},_spaceDialog:{state:!0},_infoCard:{state:!0},_markerDialog:{state:!0},_zoom:{state:!0},_view:{state:!0}},Nt.styles=Pt,customElements.get("houseplan-card")||customElements.define("houseplan-card",Nt),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.11.0 ","background:#3ea6ff;color:#04121f;font-weight:700","");
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index a895eed..8fe0ce0 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -1,101 +1,101 @@
-# Архитектура House Plan
+# House Plan architecture
-Обновлено: 2026-07-04 (v1.2.2). Репозиторий = HACS-интеграция (категория **Integration**),
-которая содержит и бэкенд (`custom_components/houseplan`), и Lovelace-карточку (`src/` → `dist/`).
+Updated: 2026-07-04 (v1.2.2). The repository = a HACS integration (category **Integration**)
+that contains both the backend (`custom_components/houseplan`) and the Lovelace card (`src/` → `dist/`).
-## Состав
+## Layout
```
houseplan-card/
-├─ src/ # исходники карточки (TypeScript + Lit 3)
-│ ├─ houseplan-card.ts # карточка: рендер, состояния, drag, tooltip, sticky-шапка
-│ ├─ editor.ts # GUI-редактор конфига (ha-form + селекторы)
-│ ├─ rules.ts # правила иконок (iconFor), курирование, группы, приоритет доменов
+├─ src/ # card sources (TypeScript + Lit 3)
+│ ├─ houseplan-card.ts # the card: rendering, states, drag, tooltip, sticky header
+│ ├─ editor.ts # GUI config editor (ha-form + selectors)
+│ ├─ rules.ts # icon rules (iconFor), curation, groups, domain priority
│ └─ data/
-│ ├─ house.ts # геометрия: ROOMS (комнаты→area), FLOOR_VB (viewBox), названия
-│ └─ backgrounds.ts # ВЕКТОРНЫЕ планы (SVG base64) + FLOOR_BG_RECT (позиционирование)
-├─ dist/houseplan-card.js # сборка (rollup+terser), ~290 КБ, планы внутри
-├─ custom_components/houseplan/ # интеграция HA
-│ ├─ __init__.py # setup: Store, WS-команды, раздача JS (add_extra_js_url)
+│ ├─ house.ts # geometry: ROOMS (rooms→area), FLOOR_VB (viewBox), names
+│ └─ backgrounds.ts # VECTOR plans (SVG base64) + FLOOR_BG_RECT (positioning)
+├─ dist/houseplan-card.js # build (rollup+terser), ~290 KB, plans embedded
+├─ custom_components/houseplan/ # the HA integration
+│ ├─ __init__.py # setup: Store, WS commands, JS serving (add_extra_js_url)
│ ├─ websocket_api.py # houseplan/layout/get|set|update
-│ ├─ config_flow.py # одна запись; опция admin_only (правка только админам)
+│ ├─ config_flow.py # single entry; admin_only option (editing restricted to admins)
│ ├─ const.py # DOMAIN, STORAGE_KEY, VERSION, FRONTEND_URL
-│ └─ frontend/houseplan-card.js # копия dist, раздаётся как /houseplan_files/houseplan-card.js
-├─ assets/ # исходники планов: f1_plan.svg, f2_plan.svg (РЕМПЛАННЕР), *_bg.png (старые растровые)
-├─ hacs.json # манифест HACS
-└─ docs/ # эта документация
+│ └─ frontend/houseplan-card.js # copy of dist, served as /houseplan_files/houseplan-card.js
+├─ assets/ # plan sources: f1_plan.svg, f2_plan.svg (REMPLANNER), *_bg.png (old raster versions)
+├─ hacs.json # HACS manifest
+└─ docs/ # this documentation
```
-## Ключевые решения
+## Key decisions
-1. **Один репозиторий — интеграция + карточка.** Интеграция раздаёт JS
- (`async_register_static_paths`) и регистрирует его как **Lovelace-ресурс** (module) —
- фронтенд дожидается ресурсов перед рендером, поэтому карточка работает и на холодном старте
- мобильного приложения (в отличие от `add_extra_js_url`, который остаётся фолбэком для
- YAML-режима). Пользователю не нужно вручную добавлять ресурс.
-2. **Раскладка иконок — на сервере.** `helpers.storage.Store(1, "houseplan.layout")` →
- `.storage/houseplan.layout`. Карточка читает/пишет через `hass.callWS`
- (`houseplan/layout/get|set|update`). Fallback — localStorage (если интеграции нет).
-3. **Без токена.** Всё из объекта `hass` фронтенда: `hass.states` (реактивно),
- `hass.devices/entities/areas` (реестры). Никаких прямых WS-подключений.
-4. **Реактивность.** Каждое изменение состояния в HA приводит к set hass → re-render.
- Температуры/LQI/вкл-выкл live по определению (проверено подменой state).
+1. **One repository — integration + card.** The integration serves the JS
+ (`async_register_static_paths`) and registers it as a **Lovelace resource** (module) —
+ the frontend waits for resources before rendering, so the card also works on a cold start
+ of the mobile app (unlike `add_extra_js_url`, which remains a fallback for
+ YAML mode). The user does not need to add the resource manually.
+2. **Icon layout lives on the server.** `helpers.storage.Store(1, "houseplan.layout")` →
+ `.storage/houseplan.layout`. The card reads/writes via `hass.callWS`
+ (`houseplan/layout/get|set|update`). Fallback — localStorage (when the integration is absent).
+3. **No token.** Everything comes from the frontend `hass` object: `hass.states` (reactive),
+ `hass.devices/entities/areas` (registries). No direct WS connections.
+4. **Reactivity.** Every state change in HA leads to set hass → re-render.
+ Temperatures/LQI/on-off are live by definition (verified by substituting state).
-## Координатная система
+## Coordinate system
-- Базовое пространство: **1489×1053** («пиксели» старого PNG-рендера, 1 ед. = 1 px).
- Все комнаты, позиции иконок и viewBox этажей — в нём. НЕ менять без миграции раскладки.
-- Векторные планы вставляются `
- ${t.model?j`
`}_renderMarkerDialog(){const t=this._markerDialog,e="virtual"===t.binding,i=this._bindingCandidates(),s=(()=>{if(e)return null;const s=i.find(e=>e.value===t.binding);if(s)return s.label;const[a,o]=t.binding.split(":");return"device"===a?this.hass.devices[o]?.name_by_user||this.hass.devices[o]?.name||o:this.hass.states[o]?.attributes?.friendly_name||o})();return j``}_renderMarkerDialog(){const t=this._markerDialog,e="virtual"===t.binding,i=this._bindingCandidates(),s=(()=>{if(e)return null;const s=i.find(e=>e.value===t.binding);if(s)return s.label;const[a,o]=t.binding.split(":");return"device"===a?this.hass.devices[o]?.name_by_user||this.hass.devices[o]?.name||o:this.hass.states[o]?.attributes?.friendly_name||o})();return F`Модель${t.model}
`:B}
- ${i?j`Состояние${i}
`:B}
- ${vt(t.link)?j`Ссылка
+ ${t.model?F`
- ${this._t("info.model")}${t.model}
`:B}
+ ${i?F`${this._t("info.state")}${i}
`:B}
+ ${vt(t.link)?F`${this._t("info.link")}
${t.link}
`:B}
- ${t.description?j`${t.description}
`:B}
- ${t.pdfs&&t.pdfs.length?j`Инструкции
- ${t.pdfs.map(t=>j`
+ ${t.description?F`
${t.description}
`:B}
+ ${t.pdfs&&t.pdfs.length?F`${this._t("info.manuals")}
+ ${t.pdfs.map(t=>F`
`:B}
- ${t.model||i||t.link||t.description||t.pdfs&&t.pdfs.length?B:j`Нет дополнительной информации
`}
+ ${t.model||i||t.link||t.description||t.pdfs&&t.pdfs.length?B:F`${this._t("info.none")}
`}
- ${t.primary?j`
t.stopPropagation()}>
`}_renderRoomDialog(){const t=this._freeAreas;return j``}_renderRoomDialog(){const t=this._freeAreas;return F``}}Ot.properties={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},_markup:{state:!0},_tool:{state:!0},_path:{state:!0},_cursorPt:{state:!0},_areaSel:{state:!0},_nameSel:{state:!0},_roomDialog:{state:!0},_spaceDialog:{state:!0},_infoCard:{state:!0},_markerDialog:{state:!0},_zoom:{state:!0},_view:{state:!0}},Ot.styles=zt,customElements.get("houseplan-card")||customElements.define("houseplan-card",Ot),window.customCards=window.customCards||[],window.customCards.find(t=>"houseplan-card"===t.type)||window.customCards.push({type:"houseplan-card",name:"House Plan Card",description:"Интерактивный план дома: пространства, комнаты, устройства с живыми состояниями и drag-раскладкой."}),console.info("%c HOUSEPLAN-CARD %c v1.10.0 ","background:#3ea6ff;color:#04121f;font-weight:700","");
+ t.stopPropagation()}>
-
- ${this._t("marker.name_label")}
+ this._markerDialog={...t,name:e.target.value}} />
-
+
`}_renderSpaceDialog(){const t=this._spaceDialog;return j``}_renderSpaceDialog(){const t=this._spaceDialog;return F`
- ${e?B:j`this._markerDialog={...t,icon:e.detail.value||""}}> `:j`${this._t("marker.icon_label")}
+ ${customElements.get("ha-icon-picker")?F`this._markerDialog={...t,icon:e.detail.value||""}}> `:F`this._markerDialog={...t,icon:e.target.value}} />`}
-
- ${this._t("marker.model_label")}
+ this._markerDialog={...t,model:e.target.value}} />
-
+
this._markerDialog={...t,link:e.target.value}} />
-
-
-
+
-
- ${i.map(e=>j`
-
+
-
- ${customElements.get("ha-icon-picker")?j`F`
this._markerDialog={...t,binding:e.value}}>
${e.label}${e.sub}
`)}
- ${i.length?B:j`ничего не найдено
`}
+ ${i.length?B:F`${this._t("marker.nothing_found")}
`}
- ${t.pdfs.map(t=>j`this._removeMarkerPdf(t.url)}> `)}
- ${t.devId?j`
t.stopPropagation()}>
- t.stopPropagation()}>
-
- ${this._t("space.title_label")}
+ this._spaceDialog={...t,title:e.target.value}} />
-
+
- ${t.planFile?j`${t.planFile.name}`:t.planUrl?j``:j`нет подложки`}
+ ${t.planFile?F`${t.planFile.name}`:t.planUrl?F``:F`${this._t("space.no_plan")}`}
- ${"edit"===t.mode?j`
-
Пространств пока нет.
+${this._t('empty.no_spaces')}
${this._serverStorage - ? html`Добавьте первое пространство и загрузите план этажа.
+ ? html`${this._t('empty.add_first')}
` - : html`Установите интеграцию House Plan и добавьте запись в «Устройства и службы».
`} + : html`${this._t('empty.install')}
`}${this._toast}
` : nothing}
@@ -1524,7 +1531,7 @@ class HouseplanCard extends LitElement {
${model.map(
@@ -1538,7 +1545,7 @@ class HouseplanCard extends LitElement {
>
${s.title}${this._norm
? html` {
e.stopPropagation();
this._openSpaceDialog('edit', s.id);
@@ -1547,37 +1554,37 @@ class HouseplanCard extends LitElement {
`,
)}
${this._norm
- ? html``
: nothing}
- ${devs.length} устр.
+ ${this._t('count.devices', { n: devs.length })}
-
+
-
+ title=${this._t('title.zoom_reset')}>
${this._norm
? html``
: nothing}
${this._norm
? html`
-
${this._tip.title}${this._tip.meta ? html`${this._tip.meta}` : nothing}
${this._tip.lqi != null
- ? html`средний сигнал zigbee:
+ ? html`${this._t('tip.lqi')}
${this._tip.lqi}`
: nothing}
`
@@ -1712,23 +1719,23 @@ class HouseplanCard extends LitElement {
return html``;
}
@@ -1741,35 +1748,35 @@ class HouseplanCard extends LitElement {
e.stopPropagation()}>
- ${d.model ? html`
`;
@@ -1790,24 +1797,24 @@ class HouseplanCard extends LitElement {
return html`Модель${d.model}
` : nothing}
- ${stateTxt ? html`Состояние${stateTxt}
` : nothing}
+ ${d.model ? html`${this._t('info.model')}${d.model}
` : nothing}
+ ${stateTxt ? html`${this._t('info.state')}${stateTxt}
` : nothing}
${safeUrl(d.link)
- ? html`Ссылка
+ ? html`
${this._t('info.link')}
${d.link}
`
: nothing}
${d.description ? html`${d.description}
` : nothing}
${d.pdfs && d.pdfs.length
- ? html`Инструкции
+ ? html`
${this._t('info.manuals')}
${d.pdfs.map(
(p) => html`
`
: nothing}
${!d.model && !stateTxt && !d.link && !d.description && !(d.pdfs && d.pdfs.length)
- ? html`Нет дополнительной информации
`
+ ? html`${this._t('info.none')}
`
: nothing}
${d.primary
? html``
: nothing}
-
+
e.stopPropagation()}>
(this._markerDialog = { ...d, icon: e.detail.value || '' })}> `
- : html` (this._markerDialog = { ...d, icon: (e.target as HTMLInputElement).value })} />`}
-
- ${this._t('marker.model_label')}
+ (this._markerDialog = { ...d, model: (e.target as HTMLInputElement).value })} />
-
+
(this._markerDialog = { ...d, link: (e.target as HTMLInputElement).value })} />
-
-
-
+
e.stopPropagation()}>
-
- ${this._t('marker.name_label')}
+ (this._markerDialog = { ...d, name: (e.target as HTMLInputElement).value })} />
-
+
-
+
-
+
${customElements.get('ha-icon-picker')
? html`
${!isVirtual
? html`
@@ -1817,43 +1824,43 @@ class HouseplanCard extends LitElement {
${c.label}${c.sub}
`,
)}
- ${!cands.length ? html`ничего не найдено
` : nothing}
+ ${!cands.length ? html`${this._t('marker.nothing_found')}
` : nothing}
${d.pdfs.map(
(p) => html` this._removeMarkerPdf(p.url)}> `,
)}
@@ -1870,13 +1877,13 @@ class HouseplanCard extends LitElement {
@@ -1888,21 +1895,21 @@ class HouseplanCard extends LitElement {
return html`
${d.devId
? html``
: nothing}
-
+
e.stopPropagation()}>
e.stopPropagation()}>
-
- ${this._t('space.title_label')}
+ (this._spaceDialog = { ...d, title: (e.target as HTMLInputElement).value })} />
-
+
${d.planFile
? html`${d.planFile.name}`
: d.planUrl
- ? html`
`
- : html`нет подложки`}
+ ? html``
+ : html`${this._t('space.no_plan')}`}
@@ -1911,15 +1918,15 @@ class HouseplanCard extends LitElement {
@@ -1930,13 +1937,13 @@ class HouseplanCard extends LitElement {
const areas = this._freeAreas;
return html`
${d.mode === 'edit'
? html``
: nothing}
-
+