feat v1.11.0: full English translation + en/ru UI localization

- All card UI strings moved to src/i18n.ts (en/ru); language follows the HA
  profile automatically, new 'language: en|ru' card option forces it; GUI
  editor localized and got the language dropdown; generated device names
  localized via BuildCtx.loc.
- English-only codebase: comments, docstrings, test names, backend error
  messages and logs. Russian remains only in the ru dictionary, ru.json,
  iconFor regexes matching Russian device names (+their fixtures) and README.ru.md.
- Docs English-first: README (EN) + README.ru.md, ARCHITECTURE/DEVELOPMENT/
  ROADMAP/CHANGELOG fully translated; translations/en.json had Russian - fixed.
- Removed obsolete RELEASE_NOTES_v1.9.3.md and scripts_publish.sh.

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<string, string>;
   markers: Marker[];
   settings: ServerConfig['settings'];
   excluded: Set<string>;
   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<string, string[]> {
@@ -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<string, number> = {};
   const rest: DevItem[] = [];
 
-  // 1) авто-устройства HA (не занятые маркером, не скрытые)
+  // 1) HA auto-discovered devices (not claimed by a marker, not hidden)
   for (const dev of Object.values<any>(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,

src/editor.ts

@@ -1,14 +1,6 @@
-/** Редактор конфигурации карточки (GUI в Lovelace). */
+/** Card configuration editor (Lovelace GUI). */
 import { LitElement, html, nothing } from 'lit';
-
-const LABELS: Record<string, string> = {
-  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<void> {
     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<string, string> = {
+      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`<ha-form
       .hass=${this.hass}
       .data=${this._config}
       .schema=${this._schema}
-      .computeLabel=${(s: any) => LABELS[s.name] || s.name}
+      .computeLabel=${(s: any) => labels[s.name] || s.name}
       @value-changed=${this._valueChanged}
     ></ha-form>`;
   }

src/i18n.ts

@@ -0,0 +1,315 @@
+/**
+ * Card UI localization. Language is resolved from the card config
+ * (`language: en|ru`) or, by default, from the HA user profile
+ * (hass.locale.language); anything that is not Russian falls back to English.
+ */
+
+export type Lang = 'en' | 'ru';
+
+const en = {
+  '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': 'Русский',
+};
+
+type Key = keyof typeof en;
+
+const ru: Record<Key, string> = {
+  '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': 'Русский',
+};
+
+const DICTS: Record<Lang, Record<Key, string>> = { en, ru };
+
+/** Resolve the UI language: explicit config option wins, then the HA profile. */
+export function langOf(hass: any, configLang?: string | null): Lang {
+  if (configLang === 'ru' || configLang === 'en') return configLang;
+  const l = (hass?.locale?.language || hass?.language || 'en').toLowerCase();
+  return l.startsWith('ru') ? 'ru' : 'en';
+}
+
+/** Translate a key with optional {placeholder} substitution. */
+export function t(lang: Lang, key: Key, vars?: Record<string, string | number>): string {
+  let s = DICTS[lang][key] ?? en[key] ?? key;
+  if (vars) for (const [k, v] of Object.entries(vars)) s = s.replace('{' + k + '}', String(v));
+  return s;
+}
+
+export type { Key as I18nKey };

src/logic.ts

@@ -1,30 +1,30 @@
 /**
- * Чистые функции без зависимостей от Lit/DOM — легко покрываются юнит-тестами.
+ * Pure functions with no Lit/DOM dependencies — easy to cover with unit tests.
  */
 
-/** Цвет LQI zigbee: ≤40 — красный, ≥180 — зелёный, между — hsl-градиент. */
+/** Zigbee LQI color: ≤40 — red, ≥180 — green, in between — an hsl gradient. */
 export function lqiColor(lqi: number): string {
   const hue = Math.max(0, Math.min(120, ((lqi - 40) / 140) * 120));
   return `hsl(${Math.round(hue)}, 85%, 55%)`;
 }
 
-/** Привязать координату к ближайшему узлу сетки с шагом pitch. */
+/** Snap a coordinate to the nearest grid node with step pitch. */
 export function snapToGrid(v: number, pitch: number): number {
   return Math.round(v / pitch) * pitch;
 }
 
-/** Канонический ключ отрезка (независим от направления). */
+/** Canonical key of a segment (independent of direction). */
 export function segKey(a: number[], b: number[]): string {
   const [p, q] = a[0] < b[0] || (a[0] === b[0] && a[1] <= b[1]) ? [a, b] : [b, a];
   return `${p[0].toFixed(1)},${p[1].toFixed(1)}-${q[0].toFixed(1)},${q[1].toFixed(1)}`;
 }
 
-/** Совпадение точек с допуском. */
+/** Point equality within a tolerance. */
 export function samePoint(a: number[], b: number[], eps = 0.001): boolean {
   return Math.abs(a[0] - b[0]) < eps && Math.abs(a[1] - b[1]) < eps;
 }
 
-/** Точка внутри полигона (ray casting). */
+/** Point inside a polygon (ray casting). */
 export function pointInPolygon(p: number[], poly: number[][]): boolean {
   let inside = false;
   for (let i = 0, j = poly.length - 1; i < poly.length; j = i++) {
@@ -36,8 +36,8 @@ export function pointInPolygon(p: number[], poly: number[][]): boolean {
 }
 
 /**
- * id маркера по привязке: device → device_id, entity → 'lg_'+entity_id,
- * virtual → переданный existing (если это уже v_-маркер) либо новый через newId().
+ * Marker id by binding: device → device_id, entity → 'lg_'+entity_id,
+ * virtual → the passed-in existing (if it is already a v_ marker) or a new one via newId().
  */
 export function markerIdForBinding(
   binding: string,
@@ -50,13 +50,13 @@ export function markerIdForBinding(
   return existingId && existingId.startsWith('v_') ? existingId : newId();
 }
 
-/** Средний LQI по набору значений (или null). */
+/** Average LQI over a set of values (or null). */
 export function averageLqi(values: number[]): number | null {
   if (!values.length) return null;
   return Math.round(values.reduce((a, b) => a + b, 0) / values.length);
 }
 
-/** Прямоугольник «contain» с заданным аспектом (w/h), вмещающий весь vb [x,y,w,h]. */
+/** “Contain” rectangle with the given aspect (w/h) that fits the whole vb [x,y,w,h]. */
 export function fitView(vb: number[], aspect: number): { x: number; y: number; w: number; h: number } {
   const planA = vb[2] / vb[3];
   if (aspect > planA) {
@@ -67,7 +67,7 @@ export function fitView(vb: number[], aspect: number): { x: number; y: number; w
   return { x: vb[0], y: vb[1] - (h - vb[3]) / 2, w, h };
 }
 
-/** Расталкивание точек: не ближе minDist друг к другу, в пределах прямоугольника b с отступом pad. Мутирует pts. */
+/** Push points apart: no closer than minDist to each other, within rectangle b with padding pad. Mutates pts. */
 export function declump(
   pts: { x: number; y: number }[],
   b: { x: number; y: number; w: number; h: number },
@@ -100,8 +100,8 @@ export function declump(
 }
 
 /**
- * Безопасный URL для <a href>: допускаются только http(s) и относительные пути.
- * Отсекает javascript:, data: и прочие опасные схемы (XSS через конфиг).
+ * Safe URL for <a href>: only http(s) and relative paths are allowed.
+ * Rejects javascript:, data: and other dangerous schemes (XSS via config).
  */
 export function safeUrl(url: string | null | undefined): string | null {
   if (!url) return null;

src/rules.ts

@@ -1,8 +1,8 @@
 /**
- * Правила прототипа — перенесены 1-в-1 из index.html/build_data.py (см. DOCUMENTATION.md §4.2–4.5).
+ * Prototype rules — ported 1-to-1 from index.html/build_data.py (see DOCUMENTATION.md §4.2–4.5).
  */
 
-/** Интеграции-домены, чьи устройства скрываются (курирование). */
+/** Integration domains whose devices are hidden (curation). */
 export const EXCLUDED_DOMAINS = new Set([
   'hacs', 'sun', 'backup', 'hassio', 'met', 'telegram_bot', 'mobile_app',
   'systemmonitor', 'better_thermostat', 'adaptive_lighting', 'yandex_pogoda',
@@ -38,7 +38,7 @@ const ICON_RULES: Array<[RegExp, string]> = [
   [/slzb|координат|zigbee/, 'mdi:zigbee'],
 ];
 
-/** Подбор MDI-иконки по имени/модели устройства. */
+/** Pick an MDI icon by device name/model. */
 export function iconFor(name?: string, model?: string): string {
   const s = ((name || '') + ' ' + (model || '')).toLowerCase();
   for (const [pat, icon] of ICON_RULES) {
@@ -47,7 +47,7 @@ export function iconFor(name?: string, model?: string): string {
   return 'mdi:chip';
 }
 
-/** Приоритет доменов для выбора «первичной» сущности устройства (more-info). */
+/** Domain priority for picking the device's “primary” entity (more-info). */
 export const DOMAIN_PRIORITY = [
   'light', 'switch', 'cover', 'valve', 'lock', 'climate', 'fan',
   'media_player', 'camera', 'vacuum', 'humidifier', 'water_heater',

src/styles.ts

@@ -1,4 +1,4 @@
-/** Стили карточки House Plan (вынесены из компонента). */
+/** Styles of the House Plan card (extracted from the component). */
 import { css } from 'lit';
 
 export const cardStyles = css`
@@ -12,7 +12,7 @@ export const cardStyles = css`
       --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;
@@ -139,7 +139,7 @@ export const cardStyles = css`
       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 {
@@ -220,7 +220,7 @@ export const cardStyles = css`
       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);

src/types.ts

@@ -1,4 +1,4 @@
-/** Общие типы карточки House Plan. */
+/** Shared types of the House Plan card. */
 
 export interface RoomCfg {
   id?: string;
@@ -8,7 +8,7 @@ export interface RoomCfg {
   y?: number;
   w?: number;
   h?: number;
-  poly?: number[][]; // полигон в рендер-единицах (модель) / нормированный (конфиг)
+  poly?: number[][]; // polygon in render units (model) / normalized (config)
 }
 
 export interface SpaceModel {
@@ -24,7 +24,7 @@ export interface PdfRef {
   url: string;
 }
 
-/** Маркер конфига: правит/дополняет авто-устройство ИЛИ описывает ручной/виртуальный значок. */
+/** Config marker: edits/augments an auto-discovered device OR describes a manual/virtual icon. */
 export interface Marker {
   id: string;
   binding: string; // 'device:<id>' | 'entity:<eid>' | 'virtual'
@@ -56,7 +56,7 @@ export interface DevItem {
   primary?: string;
   temp?: number | null;
   virtual?: boolean;
-  marker?: Marker; // связанный маркер конфига (метаданные, оверрайды)
+  marker?: Marker; // linked config marker (metadata, overrides)
   bindingKind?: 'device' | 'entity' | 'virtual';
   bindingRef?: string; // device_id / entity_id
   link?: string | null;
@@ -72,4 +72,5 @@ export interface CardConfig {
   show_temperature?: boolean;
   live_states?: boolean;
   show_signal?: boolean;
+  language?: string; // 'en' | 'ru' | '' (auto — HA profile)
 }